DOMTokenList.replace()

La méthode replace() de l'interface DOMTokenList remplace une marque (token) existante par une nouvelle marque.

Syntaxe

js
tokenList.replace(oldToken, newToken);

Paramètres

oldToken

Une DOMString (chaîne de caractères) représentant la marque que vous voulez remplacer.

newToken

Une DOMString (chaîne de caractères) représentant la marque avec laquelle vous voulez remplacer l'ancienne.

Valeur retournée

Vide.

Exemples

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 remplaçons alors la marque dans la liste et écrivons la liste dans le Node.textContent du <span>.

D'abord, le HTML :

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

Maintenant le JavaScript :

js
var span = document.querySelector("span");
var classes = span.classList;
try {
  classes.replace("c", "z");
  span.textContent = classes;
} catch (e) {
  span.textContent = e;
}

La sortie ressemble à ceci :

Spécifications

Specification
DOM Standard
# ref-for-dom-domtokenlist-replace①

Compatibilité des navigateurs

BCD tables only load in the browser