DOMTokenList.add()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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 Standard
# ref-for-dom-domtokenlist-add①

Compatibilité des navigateurs

BCD tables only load in the browser