WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen