CKTIS / JavaScript
DOMTokenList – Tokens mit classList verwalten
DOMTokenList stellt eine Menge von Tokens dar, etwa die Klassen eines Elements, die über classList zugänglich sind. Hier lernst du, Tokens hinzuzufügen, zu entfernen, umzuschalten und zu prüfen, ohne den Text des class-Attributs manuell zu verarbeiten.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList stellt eine geordnete Menge von Tokens dar und unterscheidet Groß- und Kleinschreibung. Im Attributwert trennen nur ASCII-Leerraumzeichen die Tokens. Ein geschütztes Leerzeichen (U+00A0) kann beispielsweise Teil eines einzelnen Klassentokens sein, statt zwei Klassen zu trennen. Ein häufiges Beispiel ist element.classList: ein Live-Objekt, das das class-Attribut widerspiegelt. Änderungen an der Liste aktualisieren das Attribut, und Änderungen am Attribut sind über dasselbe Objekt sichtbar. Es ist kein JavaScript-Array.
DOMTokenList.add, aufgerufen als tokens.add("card", "active"), fügt einzelne Tokens hinzu und überspringt bereits vorhandene. DOMTokenList.remove, zum Beispiel tokens.remove("active", "missing"), entfernt die angegebenen Tokens; ein fehlendes Token verursacht keinen Fehler. Beide Methoden akzeptieren mehrere Argumente und geben undefined zurück. Übergib Klassen einzeln: tokens.add("card", "active"), nicht tokens.add("card active"). Bei add() verursacht ein leeres Token eine DOMException namens SyntaxError, während ein Token mit ASCII-Leerraum InvalidCharacterError verursacht.
DOMTokenList.contains, verwendet als tokens.contains("active"), gibt true oder false zurück, ohne die Liste zu ändern. DOMTokenList.toggle, verwendet als tokens.toggle("selected"), fügt ein nicht vorhandenes Token hinzu oder entfernt ein vorhandenes. Der Rückgabewert gibt die Zugehörigkeit nach der Operation an, nicht, ob eine Änderung stattgefunden hat. Die Form tokens.toggle("ready", force) mit dem booleschen Wert true stellt sicher, dass das Token vorhanden ist; mit false wird seine Abwesenheit sichergestellt. Verwende diese Form zur Synchronisierung mit einem expliziten Zustand, statt blind umzuschalten.
Dies ist eine DOM-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet die Schnittstelle und die vier hier behandelten Methoden seit Juli 2015 als breit verfügbar; prüfe bei älteren Browsern die Unterstützung der jeweiligen Aufrufvarianten. Dass Node 24 in einem Repository vorhanden ist, belegt keine DOM-Unterstützung. Das Beispiel benötigt einen Browser; das Element muss nicht in das Dokument eingefügt sein.
Beispiele
{
const element = document.createElement("div");
const tokens = element.classList;
tokens.add("card", "active", "card");
console.log(tokens.contains("active"));
tokens.remove("active", "missing");
console.log(tokens.toggle("selected"));
console.log(tokens.toggle("selected", false));
tokens.toggle("ready", true);
console.log(element.className);
}Ergebnis
true true false card ready
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.