From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- files/fr/web/api/storage/clear/index.html | 67 ---------------- files/fr/web/api/storage/clear/index.md | 67 ++++++++++++++++ files/fr/web/api/storage/getitem/index.html | 77 ------------------ files/fr/web/api/storage/getitem/index.md | 77 ++++++++++++++++++ files/fr/web/api/storage/index.html | 105 ------------------------- files/fr/web/api/storage/index.md | 105 +++++++++++++++++++++++++ files/fr/web/api/storage/key/index.html | 80 ------------------- files/fr/web/api/storage/key/index.md | 80 +++++++++++++++++++ files/fr/web/api/storage/length/index.html | 65 --------------- files/fr/web/api/storage/length/index.md | 65 +++++++++++++++ files/fr/web/api/storage/removeitem/index.html | 83 ------------------- files/fr/web/api/storage/removeitem/index.md | 83 +++++++++++++++++++ files/fr/web/api/storage/setitem/index.html | 78 ------------------ files/fr/web/api/storage/setitem/index.md | 78 ++++++++++++++++++ 14 files changed, 555 insertions(+), 555 deletions(-) delete mode 100644 files/fr/web/api/storage/clear/index.html create mode 100644 files/fr/web/api/storage/clear/index.md delete mode 100644 files/fr/web/api/storage/getitem/index.html create mode 100644 files/fr/web/api/storage/getitem/index.md delete mode 100644 files/fr/web/api/storage/index.html create mode 100644 files/fr/web/api/storage/index.md delete mode 100644 files/fr/web/api/storage/key/index.html create mode 100644 files/fr/web/api/storage/key/index.md delete mode 100644 files/fr/web/api/storage/length/index.html create mode 100644 files/fr/web/api/storage/length/index.md delete mode 100644 files/fr/web/api/storage/removeitem/index.html create mode 100644 files/fr/web/api/storage/removeitem/index.md delete mode 100644 files/fr/web/api/storage/setitem/index.html create mode 100644 files/fr/web/api/storage/setitem/index.md (limited to 'files/fr/web/api/storage') diff --git a/files/fr/web/api/storage/clear/index.html b/files/fr/web/api/storage/clear/index.html deleted file mode 100644 index c177f94657..0000000000 --- a/files/fr/web/api/storage/clear/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Storage.clear() -slug: Web/API/Storage/clear -tags: - - API - - Méthode - - Reference - - Stockage - - Stockage Web -translation_of: Web/API/Storage/clear ---- -

{{APIRef("Web Storage API")}}

- -

La méthode clear() de l'interface {{domxref("Storage")}},  lorsqu'elle est invoquée, vide toutes les clés stockées.

- -

Syntaxe

- -
storage.clear();
- -

Retoune

- -

{{jsxref("undefined")}}

- -

Exemple

- -

La fonction suivante crée trois entrées de données dans le stockage local, puis les supprime en utilisant clear().

- -
function peuplerLeStockage() {
-  localStorage.setItem('bgcolor', 'red');
-  localStorage.setItem('font', 'Helvetica');
-  localStorage.setItem('image', 'monChat.png');
-
-  localStorage.clear();
-}
- -
-

Note : Pour voir un exemple réel, vous pouvez visitez notre Démo de stockage web. Les modifications sont visibles dans la console, vous pouvez actualiser la page et conserver les modifications.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpecificationÉtatCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-clear', 'Storage.clear')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Storage.clear")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/storage/clear/index.md b/files/fr/web/api/storage/clear/index.md new file mode 100644 index 0000000000..c177f94657 --- /dev/null +++ b/files/fr/web/api/storage/clear/index.md @@ -0,0 +1,67 @@ +--- +title: Storage.clear() +slug: Web/API/Storage/clear +tags: + - API + - Méthode + - Reference + - Stockage + - Stockage Web +translation_of: Web/API/Storage/clear +--- +

{{APIRef("Web Storage API")}}

+ +

La méthode clear() de l'interface {{domxref("Storage")}},  lorsqu'elle est invoquée, vide toutes les clés stockées.

+ +

Syntaxe

+ +
storage.clear();
+ +

Retoune

+ +

{{jsxref("undefined")}}

+ +

Exemple

+ +

La fonction suivante crée trois entrées de données dans le stockage local, puis les supprime en utilisant clear().

+ +
function peuplerLeStockage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'monChat.png');
+
+  localStorage.clear();
+}
+ +
+

Note : Pour voir un exemple réel, vous pouvez visitez notre Démo de stockage web. Les modifications sont visibles dans la console, vous pouvez actualiser la page et conserver les modifications.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpecificationÉtatCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-clear', 'Storage.clear')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Storage.clear")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/storage/getitem/index.html b/files/fr/web/api/storage/getitem/index.html deleted file mode 100644 index 1e3f950436..0000000000 --- a/files/fr/web/api/storage/getitem/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Storage.getItem() -slug: Web/API/Storage/getItem -tags: - - API - - Méthode - - Stockage - - Stockage Web -translation_of: Web/API/Storage/getItem ---- -

{{APIRef("Web Storage API")}}
- La méthode getItem() de l'interface {{domxref("Storage")}} renvoie la valeur associée à la clé passée en paramètre.

- -

Syntax

- -
var aValue = storage.getItem(keyName);
-
- -

Paramètre

- -
-
keyName
-
Une {{domxref("DOMString")}} contenant le nom de la clé voulue.
-
- -

Renvoi

- -

Une {{domxref("DOMString")}} contenant la valeur de la clé. null est renvoyé si aucune correspondance n'est trouvée.

- -

Exemple

- -

La fonction suivante récupère trois élément du stockage local, puis réutilise les valeurs renvoyés afin de modifier le style de la page .

- -
function setStyles() {
-  var currentColor = localStorage.getItem('bgcolor');
-  var currentFont = localStorage.getItem('font');
-  var currentImage = localStorage.getItem('image');
-
-  document.getElementById('bgcolor').value = currentColor;
-  document.getElementById('font').value = currentFont;
-  document.getElementById('image').value = currentImage;
-
-  htmlElem.style.backgroundColor = '#' + currentColor;
-  pElem.style.fontFamily = currentFont;
-  imgElem.setAttribute('src', currentImage);
-}
- -
-

Note : Pour voir cette fonction utilisée dans un exemple réel, dirigez-vous vers notre Demo de Stockage Web (en).

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-getitem', 'Storage.getItem')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Storage.getItem")}}

- -

Voir aussi

- -

Utilisation de l'API de stockage web

diff --git a/files/fr/web/api/storage/getitem/index.md b/files/fr/web/api/storage/getitem/index.md new file mode 100644 index 0000000000..1e3f950436 --- /dev/null +++ b/files/fr/web/api/storage/getitem/index.md @@ -0,0 +1,77 @@ +--- +title: Storage.getItem() +slug: Web/API/Storage/getItem +tags: + - API + - Méthode + - Stockage + - Stockage Web +translation_of: Web/API/Storage/getItem +--- +

{{APIRef("Web Storage API")}}
+ La méthode getItem() de l'interface {{domxref("Storage")}} renvoie la valeur associée à la clé passée en paramètre.

+ +

Syntax

+ +
var aValue = storage.getItem(keyName);
+
+ +

Paramètre

+ +
+
keyName
+
Une {{domxref("DOMString")}} contenant le nom de la clé voulue.
+
+ +

Renvoi

+ +

Une {{domxref("DOMString")}} contenant la valeur de la clé. null est renvoyé si aucune correspondance n'est trouvée.

+ +

Exemple

+ +

La fonction suivante récupère trois élément du stockage local, puis réutilise les valeurs renvoyés afin de modifier le style de la page .

+ +
function setStyles() {
+  var currentColor = localStorage.getItem('bgcolor');
+  var currentFont = localStorage.getItem('font');
+  var currentImage = localStorage.getItem('image');
+
+  document.getElementById('bgcolor').value = currentColor;
+  document.getElementById('font').value = currentFont;
+  document.getElementById('image').value = currentImage;
+
+  htmlElem.style.backgroundColor = '#' + currentColor;
+  pElem.style.fontFamily = currentFont;
+  imgElem.setAttribute('src', currentImage);
+}
+ +
+

Note : Pour voir cette fonction utilisée dans un exemple réel, dirigez-vous vers notre Demo de Stockage Web (en).

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationÉtatCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-getitem', 'Storage.getItem')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Storage.getItem")}}

+ +

Voir aussi

+ +

Utilisation de l'API de stockage web

diff --git a/files/fr/web/api/storage/index.html b/files/fr/web/api/storage/index.html deleted file mode 100644 index ed862cb650..0000000000 --- a/files/fr/web/api/storage/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Storage -slug: Web/API/Storage -tags: - - API - - Interface - - Reference - - Stockage - - Storage -translation_of: Web/API/Storage ---- -
{{APIRef("Web Storage API")}}
- -

L'interface Storage de l'API Web Storage donne accès au stockage de session (SessionStorage) ou au stockage local (LocalStorage) pour un domaine donné, vous permettant par exemple d'ajouter, de modifier ou de supprimer des éléments enregistrés.

- -

Si vous voulez manipuler le stockage de session pour un domaine, appelez la méthode {{domxref("Window.sessionStorage")}}. Si vous voulez manipuler le stockage local pour un domaine, appelez la méthode {{domxref("Window.localStorage")}}.

- -

Propriétés

- -
-
{{domxref("Storage.length")}} {{readonlyInline}}
-
Renvoie un entier représentant le nombre d'éléments contenus dans l'objet Storage.
-
- -

Méthodes

- -
-
{{domxref("Storage.key()")}}
-
Lorsqu'on lui passe un nombre n, cette méthode renvoie le nom de la n-ième clé dans le stockage.
-
- -
-
{{domxref("Storage.getItem()")}}
-
Lorqu'on lui passe le nom d'une clé, cette méthode renvoie la valeur de la clé correspondante.
-
{{domxref("Storage.setItem()")}}
-
Lorqu'on lui passe un nom de clé et une valeur, cette méthode ajoute cette clé et cette valeur dans le stockage. Si la clé existe déjà, elle met à jour la valeur.
-
{{domxref("Storage.removeItem()")}}
-
Lorqu'on lui passe le nom d'une clé, cette méthode supprime cette clé du stockage.
-
{{domxref("Storage.clear()")}}
-
Lorsqu'elle est appelée, cette méthode supprime toutes les clés du stockage.
-
- -

Exemples

- -

Nous accédons ici à un objet Storage en appelant localStorage. Nous testons d'abord si le stockage local contient des éléments en utilisant !localStorage.getItem('bgcolor'). Si oui, nous exécutons une fonction appelée setStyles() qui récupère les éléments en utilisant {{domxref("Storage.getItem()")}}, et utilise ces valeurs pour mettre à jour les styles de page. Sinon, nous exécutons une autre fonction appelée populateStorage(), qui utilise {{domxref("Storage.setItem()")}} pour régler les valeurs des éléments, puis qui exécute setStyles().

- -
if(!localStorage.getItem('bgcolor')) {
-  populateStorage();
-} else {
-  setStyles();
-}
-
-function populateStorage() {
-  localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
-  localStorage.setItem('font', document.getElementById('font').value);
-  localStorage.setItem('image', document.getElementById('image').value);
-
-  setStyles();
-}
-
-function setStyles() {
-  var currentColor = localStorage.getItem('bgcolor');
-  var currentFont = localStorage.getItem('font');
-  var currentImage = localStorage.getItem('image');
-
-  document.getElementById('bgcolor').value = currentColor;
-  document.getElementById('font').value = currentFont;
-  document.getElementById('image').value = currentImage;
-
-  htmlElem.style.backgroundColor = '#' + currentColor;
-  pElem.style.fontFamily = currentFont;
-  imgElem.setAttribute('src', currentImage);
-}
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'webstorage.html#the-storage-interface', 'Storage')}}{{Spec2('Web Storage')}}
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Storage")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/storage/index.md b/files/fr/web/api/storage/index.md new file mode 100644 index 0000000000..ed862cb650 --- /dev/null +++ b/files/fr/web/api/storage/index.md @@ -0,0 +1,105 @@ +--- +title: Storage +slug: Web/API/Storage +tags: + - API + - Interface + - Reference + - Stockage + - Storage +translation_of: Web/API/Storage +--- +
{{APIRef("Web Storage API")}}
+ +

L'interface Storage de l'API Web Storage donne accès au stockage de session (SessionStorage) ou au stockage local (LocalStorage) pour un domaine donné, vous permettant par exemple d'ajouter, de modifier ou de supprimer des éléments enregistrés.

+ +

Si vous voulez manipuler le stockage de session pour un domaine, appelez la méthode {{domxref("Window.sessionStorage")}}. Si vous voulez manipuler le stockage local pour un domaine, appelez la méthode {{domxref("Window.localStorage")}}.

+ +

Propriétés

+ +
+
{{domxref("Storage.length")}} {{readonlyInline}}
+
Renvoie un entier représentant le nombre d'éléments contenus dans l'objet Storage.
+
+ +

Méthodes

+ +
+
{{domxref("Storage.key()")}}
+
Lorsqu'on lui passe un nombre n, cette méthode renvoie le nom de la n-ième clé dans le stockage.
+
+ +
+
{{domxref("Storage.getItem()")}}
+
Lorqu'on lui passe le nom d'une clé, cette méthode renvoie la valeur de la clé correspondante.
+
{{domxref("Storage.setItem()")}}
+
Lorqu'on lui passe un nom de clé et une valeur, cette méthode ajoute cette clé et cette valeur dans le stockage. Si la clé existe déjà, elle met à jour la valeur.
+
{{domxref("Storage.removeItem()")}}
+
Lorqu'on lui passe le nom d'une clé, cette méthode supprime cette clé du stockage.
+
{{domxref("Storage.clear()")}}
+
Lorsqu'elle est appelée, cette méthode supprime toutes les clés du stockage.
+
+ +

Exemples

+ +

Nous accédons ici à un objet Storage en appelant localStorage. Nous testons d'abord si le stockage local contient des éléments en utilisant !localStorage.getItem('bgcolor'). Si oui, nous exécutons une fonction appelée setStyles() qui récupère les éléments en utilisant {{domxref("Storage.getItem()")}}, et utilise ces valeurs pour mettre à jour les styles de page. Sinon, nous exécutons une autre fonction appelée populateStorage(), qui utilise {{domxref("Storage.setItem()")}} pour régler les valeurs des éléments, puis qui exécute setStyles().

+ +
if(!localStorage.getItem('bgcolor')) {
+  populateStorage();
+} else {
+  setStyles();
+}
+
+function populateStorage() {
+  localStorage.setItem('bgcolor', document.getElementById('bgcolor').value);
+  localStorage.setItem('font', document.getElementById('font').value);
+  localStorage.setItem('image', document.getElementById('image').value);
+
+  setStyles();
+}
+
+function setStyles() {
+  var currentColor = localStorage.getItem('bgcolor');
+  var currentFont = localStorage.getItem('font');
+  var currentImage = localStorage.getItem('image');
+
+  document.getElementById('bgcolor').value = currentColor;
+  document.getElementById('font').value = currentFont;
+  document.getElementById('image').value = currentImage;
+
+  htmlElem.style.backgroundColor = '#' + currentColor;
+  pElem.style.fontFamily = currentFont;
+  imgElem.setAttribute('src', currentImage);
+}
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'webstorage.html#the-storage-interface', 'Storage')}}{{Spec2('Web Storage')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Storage")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/storage/key/index.html b/files/fr/web/api/storage/key/index.html deleted file mode 100644 index 97e9160b4c..0000000000 --- a/files/fr/web/api/storage/key/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Storage.key() -slug: Web/API/Storage/key -tags: - - API - - Méthode - - Reference - - Stockage - - Storage - - Web Storage -translation_of: Web/API/Storage/key ---- -

{{APIRef()}}

- -

La méthode key() de l'interface {{domxref("Storage")}} prend un nombre n en argument et retourne la n-ième clé contenue dans storage. L'ordre des clés étant définie par le navigateur, il est recommandé de ne pas s'y référer .

- -

Syntax

- -
var unNomDeCle = storage.key(cle);
- -

Paramètres

- -
-
cle
-
Un entier représentant le numéro de la clé voulue. L'index débute à zero.
-
- -

Valeur de retour

- -

Un {{domxref("DOMString")}} contenant le nom de la clé .

- -

Exemple

- -

La fonction suivante parcours les éléments présents dans le local storage.

- -
function forEachKey(callback) {
-  for (var i = 0; i < localStorage.length; i++) {
-    callback(localStorage.key(i));
-  }
-}
- -
-

Note : Pour un exemple plus poussé, consultez la Web Storage Demo.

-
- -

Autre exemple

- -

La fonction suivante parcourt chaque clé présente dans le localStorage et affiche les valeurs correspondantes.

- -
for (var i = 0; i < localStorage.length; i++) {
-   console.log(localStorage.getItem(localStorage.key(i)));
-}
-
- -

Specifications

- - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-key', 'Storage.key')}}{{Spec2('HTML WHATWG')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("api.Storage.key")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/storage/key/index.md b/files/fr/web/api/storage/key/index.md new file mode 100644 index 0000000000..97e9160b4c --- /dev/null +++ b/files/fr/web/api/storage/key/index.md @@ -0,0 +1,80 @@ +--- +title: Storage.key() +slug: Web/API/Storage/key +tags: + - API + - Méthode + - Reference + - Stockage + - Storage + - Web Storage +translation_of: Web/API/Storage/key +--- +

{{APIRef()}}

+ +

La méthode key() de l'interface {{domxref("Storage")}} prend un nombre n en argument et retourne la n-ième clé contenue dans storage. L'ordre des clés étant définie par le navigateur, il est recommandé de ne pas s'y référer .

+ +

Syntax

+ +
var unNomDeCle = storage.key(cle);
+ +

Paramètres

+ +
+
cle
+
Un entier représentant le numéro de la clé voulue. L'index débute à zero.
+
+ +

Valeur de retour

+ +

Un {{domxref("DOMString")}} contenant le nom de la clé .

+ +

Exemple

+ +

La fonction suivante parcours les éléments présents dans le local storage.

+ +
function forEachKey(callback) {
+  for (var i = 0; i < localStorage.length; i++) {
+    callback(localStorage.key(i));
+  }
+}
+ +
+

Note : Pour un exemple plus poussé, consultez la Web Storage Demo.

+
+ +

Autre exemple

+ +

La fonction suivante parcourt chaque clé présente dans le localStorage et affiche les valeurs correspondantes.

+ +
for (var i = 0; i < localStorage.length; i++) {
+   console.log(localStorage.getItem(localStorage.key(i)));
+}
+
+ +

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-key', 'Storage.key')}}{{Spec2('HTML WHATWG')}} 
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Storage.key")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/storage/length/index.html b/files/fr/web/api/storage/length/index.html deleted file mode 100644 index b8479be8fa..0000000000 --- a/files/fr/web/api/storage/length/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Storage.length -slug: Web/API/Storage/length -tags: - - API - - Propriété - - Reference - - Stockage - - Web Stockage -translation_of: Web/API/Storage/length ---- -

{{APIRef("Web Storage API")}}

- -

La propriété en lecture seule de l'interface {{domxref("Storage")}} retourne un entier représentant le nombre d'items stockés dans l'objet Storage.

- -

Syntaxe

- -
var aLength = storage.length;
- -

Retour

- -

Un entier.

- -

Exemple

- -

La fonction suivante ajoute trois éléments au localStorage du domaine courant puis retourne le nombre d'éléments dans le storage:

- -
function populateStorage() {
-  localStorage.setItem('bgcolor', 'yellow');
-  localStorage.setItem('font', 'Helvetica');
-  localStorage.setItem('image', 'cats.png');
-
-  localStorage.length; // retourne 3 si localStorage est vide au préalable
-}
- -
-

Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-length', 'Storage.length')}}{{Spec2('HTML WHATWG')}} 
- -

Compatibilité des navigateurs

- -

{{Compat("api.Storage.length")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/storage/length/index.md b/files/fr/web/api/storage/length/index.md new file mode 100644 index 0000000000..b8479be8fa --- /dev/null +++ b/files/fr/web/api/storage/length/index.md @@ -0,0 +1,65 @@ +--- +title: Storage.length +slug: Web/API/Storage/length +tags: + - API + - Propriété + - Reference + - Stockage + - Web Stockage +translation_of: Web/API/Storage/length +--- +

{{APIRef("Web Storage API")}}

+ +

La propriété en lecture seule de l'interface {{domxref("Storage")}} retourne un entier représentant le nombre d'items stockés dans l'objet Storage.

+ +

Syntaxe

+ +
var aLength = storage.length;
+ +

Retour

+ +

Un entier.

+ +

Exemple

+ +

La fonction suivante ajoute trois éléments au localStorage du domaine courant puis retourne le nombre d'éléments dans le storage:

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'yellow');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'cats.png');
+
+  localStorage.length; // retourne 3 si localStorage est vide au préalable
+}
+ +
+

Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-length', 'Storage.length')}}{{Spec2('HTML WHATWG')}} 
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Storage.length")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/storage/removeitem/index.html b/files/fr/web/api/storage/removeitem/index.html deleted file mode 100644 index 40a61a48e0..0000000000 --- a/files/fr/web/api/storage/removeitem/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Storage.removeItem() -slug: Web/API/Storage/removeItem -tags: - - API - - Méthode - - Stockage - - Stockage Web -translation_of: Web/API/Storage/removeItem ---- -

{{APIRef("Web Storage API")}}

- -

La méthode removeItem() de l'interface {{domxref("Storage")}} , lorsque vous lui passez une clé en argument, va supprimer la ressource avec le nom de clé correspondant du storage. L'interface Storage de l'API Web Storage API fournit des accès particuliers dans les domaines des stockages locaux et de sessions.

- -

Si aucun élement n'est donné en paramètre nomCle, cette méthode ne fait rien.

- -

Syntaxe

- -
storage.removeItem(nomCle);
- -

Paramètres

- -
-
nomCle
-
Un {{domxref("DOMString")}} contenant le nom de la clé que vous voulez supprimer.
-
- -

Valeur de retour

- -

{{jsxref("undefined")}}.

- -

Exemple

- -

La fonction suivante crée trois données dans le stockage local, puis va supprimer la donnée image.

- -
function populateStorage() {
-  localStorage.setItem('bgcolor', 'red');
-  localStorage.setItem('font', 'Helvetica');
-  localStorage.setItem('image', 'myCat.png');
-
-  localStorage.removeItem('image');
-}
- -

Nous pouvons également faire ceci avec le stockage de session.

- -
function populateStorage() {
-  sessionStorage.setItem('bgcolor', 'red');
-  sessionStorage.setItem('font', 'Helvetica');
-  sessionStorage.setItem('image', 'myCat.png');
-
-  sessionStorage.removeItem('image');
-}
- -
-

Note : Pour voir ce code en fonctionnement, voir Web Storage Demo.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatusComment
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-removeitem', 'Storage.removeItem')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- - - -

{{Compat("api.Storage.removeItem")}}

- -

Voir aussi

- -

Utilisation de l'API de stockage Web

diff --git a/files/fr/web/api/storage/removeitem/index.md b/files/fr/web/api/storage/removeitem/index.md new file mode 100644 index 0000000000..40a61a48e0 --- /dev/null +++ b/files/fr/web/api/storage/removeitem/index.md @@ -0,0 +1,83 @@ +--- +title: Storage.removeItem() +slug: Web/API/Storage/removeItem +tags: + - API + - Méthode + - Stockage + - Stockage Web +translation_of: Web/API/Storage/removeItem +--- +

{{APIRef("Web Storage API")}}

+ +

La méthode removeItem() de l'interface {{domxref("Storage")}} , lorsque vous lui passez une clé en argument, va supprimer la ressource avec le nom de clé correspondant du storage. L'interface Storage de l'API Web Storage API fournit des accès particuliers dans les domaines des stockages locaux et de sessions.

+ +

Si aucun élement n'est donné en paramètre nomCle, cette méthode ne fait rien.

+ +

Syntaxe

+ +
storage.removeItem(nomCle);
+ +

Paramètres

+ +
+
nomCle
+
Un {{domxref("DOMString")}} contenant le nom de la clé que vous voulez supprimer.
+
+ +

Valeur de retour

+ +

{{jsxref("undefined")}}.

+ +

Exemple

+ +

La fonction suivante crée trois données dans le stockage local, puis va supprimer la donnée image.

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+
+  localStorage.removeItem('image');
+}
+ +

Nous pouvons également faire ceci avec le stockage de session.

+ +
function populateStorage() {
+  sessionStorage.setItem('bgcolor', 'red');
+  sessionStorage.setItem('font', 'Helvetica');
+  sessionStorage.setItem('image', 'myCat.png');
+
+  sessionStorage.removeItem('image');
+}
+ +
+

Note : Pour voir ce code en fonctionnement, voir Web Storage Demo.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatusComment
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-removeitem', 'Storage.removeItem')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.Storage.removeItem")}}

+ +

Voir aussi

+ +

Utilisation de l'API de stockage Web

diff --git a/files/fr/web/api/storage/setitem/index.html b/files/fr/web/api/storage/setitem/index.html deleted file mode 100644 index ce945681ff..0000000000 --- a/files/fr/web/api/storage/setitem/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Storage.setItem() -slug: Web/API/Storage/setItem -tags: - - API - - Méthode - - Stockage - - Stockage Web -translation_of: Web/API/Storage/setItem ---- -

{{APIRef("Web Storage API")}}

- -

La méthode setItem() de l'interface {{domxref("Storage")}}, lorsque lui sont passées le duo clé-valeur, les ajoute à l'emplacement de stockage, sinon elle met à jour la valeur si la clé existe déjà.

- -

Syntaxe

- -
storage.setItem(nomClé, valeurClé);
- -

Paramètres

- -
-
nomClé
-
C'est une {{domxref("DOMString")}} contenant le nom de la clé que l'on souhaite créer/modifier.
-
valeurClé
-
C'est une {{domxref("DOMString")}} contenant la valeur associée à son nom de clé que l'on souhaite créer/modifier.
-
- -

Retourne

- -

Aucune valeur de retour.

- -

Exceptions

- -

setItem() peut émettre une exception si l'emplacement de stockage est plein. En particulier pour Safari mobile (depuis iOS 5), elle émettra une exception si l'utilisateur passe en navigation privée (contrairement aux autres navigateur qui autorisent le stockage même en navigation privée en utilisant un conteneur de données séparé, Safari met son quota de stockage à 0 octets).
- Par conséquent les développeurs devraient être sûrs de toujours de systématiquement capturer toute possible exception venant de setItem().

- -

Exemple

- -

La fonction suivante crée trois éléments à l'intérieur du stockage local.

- -
function remplissageStockage() {
-  localStorage.setItem('bgcolor', 'red');
-  localStorage.setItem('font', 'Helvetica');
-  localStorage.setItem('image', 'myCat.png');
-}
- -
-

Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.

-
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-setitem', 'Storage.setItem')}}{{Spec2('HTML WHATWG')}}
- -

Compatibilité des navigateurs

- -

{{Compat("api.Storage.setItem")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/storage/setitem/index.md b/files/fr/web/api/storage/setitem/index.md new file mode 100644 index 0000000000..ce945681ff --- /dev/null +++ b/files/fr/web/api/storage/setitem/index.md @@ -0,0 +1,78 @@ +--- +title: Storage.setItem() +slug: Web/API/Storage/setItem +tags: + - API + - Méthode + - Stockage + - Stockage Web +translation_of: Web/API/Storage/setItem +--- +

{{APIRef("Web Storage API")}}

+ +

La méthode setItem() de l'interface {{domxref("Storage")}}, lorsque lui sont passées le duo clé-valeur, les ajoute à l'emplacement de stockage, sinon elle met à jour la valeur si la clé existe déjà.

+ +

Syntaxe

+ +
storage.setItem(nomClé, valeurClé);
+ +

Paramètres

+ +
+
nomClé
+
C'est une {{domxref("DOMString")}} contenant le nom de la clé que l'on souhaite créer/modifier.
+
valeurClé
+
C'est une {{domxref("DOMString")}} contenant la valeur associée à son nom de clé que l'on souhaite créer/modifier.
+
+ +

Retourne

+ +

Aucune valeur de retour.

+ +

Exceptions

+ +

setItem() peut émettre une exception si l'emplacement de stockage est plein. En particulier pour Safari mobile (depuis iOS 5), elle émettra une exception si l'utilisateur passe en navigation privée (contrairement aux autres navigateur qui autorisent le stockage même en navigation privée en utilisant un conteneur de données séparé, Safari met son quota de stockage à 0 octets).
+ Par conséquent les développeurs devraient être sûrs de toujours de systématiquement capturer toute possible exception venant de setItem().

+ +

Exemple

+ +

La fonction suivante crée trois éléments à l'intérieur du stockage local.

+ +
function remplissageStockage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+}
+ +
+

Note : Pour voir ceci utilisé dans un exemple concret, regardez notre Web Storage Demo.

+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', 'webstorage.html#dom-storage-setitem', 'Storage.setItem')}}{{Spec2('HTML WHATWG')}}
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.Storage.setItem")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf