DOMTokenList: remove()-Methode

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.

Die remove()-Methode der DOMTokenList-Schnittstelle entfernt die angegebenen Token aus der Liste.

Syntax

js
remove(token1)
remove(token1, token2)
remove(token1, token2, /* …, */ tokenN)

Parameter

token1, …, tokenN

Ein String, der den Token repräsentiert, den Sie aus der Liste entfernen möchten. Wenn der String nicht in der Liste ist, wird kein Fehler ausgelöst und es passiert nichts.

Rückgabewert

Keiner (undefined).

Beispiele

Im folgenden Beispiel rufen wir die Liste der Klassen ab, die auf einem <span>-Element als DOMTokenList mithilfe von Element.classList gesetzt sind. Dann entfernen wir einen Token aus der Liste und schreiben die Liste in den Node.textContent des <span>.

Zuerst das HTML:

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

Nun das JavaScript:

js
const span = document.getElementById("ab");
const classes = span.classList;
classes.remove("c");
span.textContent = classes;

Um mehrere Klassen auf einmal zu entfernen, können Sie mehrere Token angeben. Die Reihenfolge, in der Sie die Token angeben, muss nicht mit der Reihenfolge übereinstimmen, in der sie in der Liste erscheinen:

js
const span2 = document.getElementById("a");
const classes2 = span2.classList;

classes2.remove("c", "b");
span2.textContent = classes2;

Die Ausgabe sieht folgendermaßen aus:

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser