From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/api/domtokenlist/foreach/index.html | 98 ++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 files/fr/web/api/domtokenlist/foreach/index.html (limited to 'files/fr/web/api/domtokenlist/foreach') diff --git a/files/fr/web/api/domtokenlist/foreach/index.html b/files/fr/web/api/domtokenlist/foreach/index.html new file mode 100644 index 0000000000..a472bdc26d --- /dev/null +++ b/files/fr/web/api/domtokenlist/foreach/index.html @@ -0,0 +1,98 @@ +--- +title: DOMTokenList.forEach() +slug: Web/API/DOMTokenList/forEach +tags: + - API + - Boucle + - Chaînes de caractères + - DOM + - Itérateurs + - Méthodes + - Pour chaque +translation_of: Web/API/DOMTokenList/forEach +--- +

{{APIRef("DOM")}}

+ +

La méthode forEach() de l'interface {{domxref("DOMTokenList")}} appelle le retour donné en paramètre, un pour chaque paire de valeurs dans la liste, dans l'ordre d'insertion.

+ +

Syntaxe

+ +
tokenList.forEach(callback);
+tokenList.forEach(callback, argument);
+
+ +

Paramètres

+ +
+
callback
+
Fonction à exécuter pour chaque élément, prenant éventuellement 3 arguments : +
+
currentValue
+
L'élément en cours de traitement dans le tableau.
+
currentIndex
+
L'index de l'élément en cours de traitement dans le tableau.
+
listObj
+
Le tableau que forEach() est en train d'appliquer.
+
+
+
argument {{Optional_inline}}
+
Valeur à utiliser comme {{jsxref("this")}} lors de l'exécution du callback (rappel).
+
+ +

Valeur renvoyée

+ +

{{jsxref('undefined')}} (indéfinie).

+ +

Exemple

+ +

Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément {{htmlelement("span")}} en tant que DOMTokenList en utilisant {{domxref("Element.classList")}}. Nous récupérons un itérateur contenant les valeurs avec forEach() et écrivons chacune d'elles dans le  {{domxref("Node.textContent")}} du <span> pendant l'exécution de la fonction interne forEach().

+ +

HTML

+ +
<span class="a b c"></span>
+ +

JavaScript

+ +
var span = document.querySelector("span");
+var classes = span.classList;
+var iterator = classes.values();
+
+classes.forEach(
+  function(value, key, listObj) {
+    span.textContent += value + ' ' + key + "/" + this + '  ++  ';
+  },
+  "arg"
+);
+ +

Résultat

+ +

{{ EmbedLiveSample('Example', '100%', 60) }}

+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('DOM WHATWG','#interface-domtokenlist','forEach() (as iterable<Node>)')}}{{Spec2('DOM WHATWG')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +
{{Compat("api.DOMTokenList.forEach")}}
+ +
 
+ +

Voir aussi

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