CKTIS / JavaScript
Element.classList — Klassen eines Elements verwalten
Element.classList stellt eine live aktualisierte DOMTokenList bereit, mit der einzelne Klassen gelesen und geändert werden können, ohne das gesamte class-Attribut zu ersetzen.
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
element.classList
element.classList.add(...tokens)
element.classList.remove(...tokens)
element.classList.contains(token)
element.classList.toggle(token, force)
element.classList.replace(token, newToken)Element.classList gibt dieselbe live aktualisierte DOMTokenList zurück: Änderungen am class-Attribut werden darin übernommen. Sie enthält eindeutige Tokens in einer bestimmten Reihenfolge. Ohne Klassen ist die Liste leer.
add(...tokens) fügt Klassen ohne Duplikate hinzu, remove(...tokens) entfernt angegebene Klassen und contains(token) prüft, ob eine Klasse enthalten ist. Übergib einzelne Argumente, nicht eine Zeichenfolge mit Leerzeichen.
toggle(token) schaltet die Zugehörigkeit um; das optionale force erzwingt das Hinzufügen (true) oder Entfernen (false). Das Ergebnis zeigt an, ob das Token am Ende enthalten ist. replace(token, newToken) gibt zurück, ob ein Token ersetzt wurde.
Methoden, die Änderungen vornehmen, weisen ein leeres Token mit SyntaxError und ASCII-Leerraum innerhalb eines Tokens mit InvalidCharacterError zurück — beides sind DOMException-Ausnahmen. Dies ist eine DOM-API und kein ECMAScript-Feature; Node 24 belegt keine Browserunterstützung.
Beispiele
const element = document.createElement('div');
const classes = element.classList;
classes.add('card', 'selected');
classes.add('card');
classes.toggle('selected', false);
classes.replace('card', 'panel');
console.log(element.className);
console.log(classes.contains('selected'));
element.className = 'ready';
console.log(classes.contains('ready'));Ergebnis
panel false true
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.