DOMTokenList.forEach()
La méthode forEach()
de l'interface 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
Facultatif-
Valeur à utiliser comme
this
lors de l'exécution ducallback
(rappel).
Valeur renvoyée
undefined
(indéfinie).
Exemple
Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément <span>
en tant que DOMTokenList
en utilisant Element.classList
. Nous récupérons un itérateur contenant les valeurs avec forEach()
et écrivons chacune d'elles dans le 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
Spécifications
No specification found
No specification data found for api.DOMTokenList.forEach
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
DOMSettableTokenList
(objet qui étend DOMTokenList avec la propriété définissable .value)