Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

DOMTokenList.add()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La méthode add() de l'interface DOMTokenList ajoute le token (marque) à la liste.

Syntaxe

js
tokenList.add(token1[, token2[, ...]]);

Paramètres

token

Une DOMString (chaîne de caractères) représentant la marque (token) que vous souhaitez ajouter à la liste.

Valeur renvoyée

Vide.

Exemples

Dans l'exemple suivant, nous récupérons une liste des classes définies sur un élément <span> en tant que DOMTokenList, en utilisant Element.classList. Nous ajoutons alors une nouvelle marque à la liste et écrivons la liste dans un Node.textContent du <span>.

Tout d'abord, le code HTML :

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

Maintenant, le JavaScript :

js
var span = document.querySelector("span");
var classes = span.classList;
classes.add("d");
span.textContent = classes;

La sortie ressemble à ceci :

Vous pouvez ajouter plusieurs token :

js
span.classList.add("d", "e", "f");

Spécifications

Specification
DOM
# ref-for-dom-domtokenlist-add①

Compatibilité des navigateurs