diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/domtokenlist/foreach | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/api/domtokenlist/foreach')
-rw-r--r-- | files/fr/web/api/domtokenlist/foreach/index.html | 98 |
1 files changed, 98 insertions, 0 deletions
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 +--- +<p>{{APIRef("DOM")}}</p> + +<p>La méthode <strong><code>forEach()</code></strong> 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.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox"><var>tokenList</var><em>.</em>forEach(<var>callback</var>); +<em>tokenList.</em>forEach<em>(callback, argument);</em> +</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>callback</code></dt> + <dd>Fonction à exécuter pour chaque élément, prenant éventuellement 3 arguments : + <dl> + <dt><em><code>currentValue</code></em></dt> + <dd>L'élément en cours de traitement dans le tableau.</dd> + <dt><code><em>currentIndex</em></code></dt> + <dd>L'index de l'élément en cours de traitement dans le tableau.</dd> + <dt><em><code>listObj</code></em></dt> + <dd>Le tableau que <code>forEach()</code> est en train d'appliquer.</dd> + </dl> + </dd> + <dt><em><code>argument</code></em><code> {{Optional_inline}}</code></dt> + <dd>Valeur à utiliser comme {{jsxref("this")}} lors de l'exécution du <code>callback</code> (<em>rappel</em>).</dd> +</dl> + +<h3 id="Valeur_renvoyée">Valeur renvoyée</h3> + +<p>{{jsxref('undefined')}} (<em>indéfinie</em>).</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément {{htmlelement("span")}} en tant que <code>DOMTokenList</code> en utilisant {{domxref("Element.classList")}}. Nous récupérons un itérateur contenant les valeurs avec <code>forEach()</code> et écrivons chacune d'elles dans le {{domxref("Node.textContent")}} du <code><span></code> pendant l'exécution de la fonction interne <code>forEach()</code>.</p> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html"><span class="a b c"></span></pre> + +<h3 id="JavaScript">JavaScript</h3> + +<pre class="brush: js">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" +);</pre> + +<h3 id="Résultat">Résultat</h3> + +<p>{{ EmbedLiveSample('Example', '100%', 60) }}</p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Statut</th> + <th scope="col">Commentaire</th> + </tr> + <tr> + <td>{{SpecName('DOM WHATWG','#interface-domtokenlist','forEach() (as iterable<Node>)')}}</td> + <td>{{Spec2('DOM WHATWG')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div>{{Compat("api.DOMTokenList.forEach")}}</div> + +<div id="compat-desktop"> </div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{domxref("DOMSettableTokenList")}} (objet qui étend DOMTokenList avec la propriété définissable <em>.value</em>)</li> +</ul> |