DOMTokenList.remove()

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 remove() de l'interface DOMTokenList supprime sur la liste la marque (token) spécifiée.

Syntaxe

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

Paramètres

tokenN...

Une DOMString (chaîne de caractères) représentant la marque que vous voulez supprimer sur la liste. Si la chaîne de caractères n'existe pas sur la liste, aucune erreur n'est levée et rien ne se passe.

Valeur retournée

Vide.

Exemples

Dans l'exemple suivant, nous récupérons la liste des classes définies dans l'élément <span> en tant que DOMTokenList en utilisant Element.classList. Nous retirons ensuite une marque sur 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;
classes.remove("c");
span.textContent = classes;

La sortie ressemble à ceci :

Pour supprimer plusieurs classes à la fois, vous pouvez utiliser un tableau (array) avec la syntaxe de décomposition. L'ordre des classes n'a pas d'importance :

js
let span = document.getElementsByTagName("span")[0],
  classes = span.classList;

classes.remove(...["c", "b"]);
span.textContent = classes;

Spécifications

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

Compatibilité des navigateurs

BCD tables only load in the browser