DOMTokenList.replace()

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

Syntaxe

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 :

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

Maintenant le JavaScript :

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

Spécification Statut Commentaire
DOM
La définition de 'replace()' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser