CKTIS / JavaScript
DOMTokenList: Tokens hinzufügen und entfernen
Mit `add()` und `remove()` änderst du einzelne Tokens wie die Klassennamen eines Elements, ohne das ganze Attribut zu ersetzen. Ein ungültiges Token kann den Aufruf abbrechen.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
tokenList.add(...tokens);
tokenList.remove(...tokens);add() und remove() sind Instanzmethoden von DOMTokenList, einer geordneten Menge eindeutiger Tokens, die Groß- und Kleinschreibung unterscheidet. element.classList liefert eine Liste, die mit dem Attribut class verbunden bleibt: Änderungen an der Liste aktualisieren das Attribut, und Änderungen am Attribut sind auch über eine zuvor gespeicherte Listenreferenz sichtbar. Andere Eigenschaften wie HTMLLinkElement.relList liefern ebenfalls eine DOMTokenList.
add() hängt fehlende Tokens in der Reihenfolge der Argumente an, ohne Duplikate zu erzeugen. remove() entfernt passende Tokens und ignoriert gültige Tokens, die nicht vorkommen. Beide Methoden nehmen null oder mehr Tokens entgegen und geben bei Erfolg undefined zurück. Ohne Argumente bleiben dieselben Tokens enthalten, aber beim Zurückschreiben des Attributs können seine Abstände vereinheitlicht und doppelte Einträge aus seinem Text entfernt werden.
Übergib jeden Klassennamen als eigenen String: element.classList.add("a", "b"), nicht element.classList.add("a b"). Verwende den Klassennamen ("a"), keinen CSS-Selektor (".a"). Beide Methoden prüfen alle Tokens, bevor sie die Liste ändern. Ein leerer String ("") löst eine DOMException namens SyntaxError aus; ein Token mit einem ASCII-Leerraumzeichen wie einem Leerzeichen oder Tabulator löst InvalidCharacterError aus. In beiden Fällen wird auch ein früheres gültiges Token aus demselben Aufruf nicht angewendet.
element.classList.remove() entfernt Tokens, nicht das Element selbst. element.remove() löst das Element von seinem Elternknoten. DOMTokenList ist eine DOM-Schnittstelle der Webplattform und kein Bestandteil von ECMAScript 2024. Prüfe, ob deine Zielumgebung die benötigten DOM-APIs bereitstellt.
Beispiele
{
const card = typeof document === "undefined"
? createClassOnlyCard()
: document.createElement("div");
card.setAttribute("class", "card is-loading");
const tokens = card.classList;
tokens.add("is-active", "is-ready", "is-active");
console.log(card.getAttribute("class"));
tokens.remove("is-loading", "missing");
console.log(card.getAttribute("class"));
try {
tokens.add("pending", "two words");
} catch (error) {
console.log(error.name);
}
try {
tokens.remove("card", "");
} catch (error) {
console.log(error.name);
}
console.log(card.getAttribute("class"));
// Without a DOM, model only the class attribute and the operations used here.
function createClassOnlyCard() {
let value = null;
const asciiWhitespace = /[\t\n\f\r ]+/;
function update(tokens, apply) {
for (const token of tokens) {
if (token === "") {
throw new DOMException("A token must not be empty.", "SyntaxError");
}
if (asciiWhitespace.test(token)) {
throw new DOMException("A token must not contain ASCII whitespace.", "InvalidCharacterError");
}
}
const classes = new Set((value ?? "").split(asciiWhitespace).filter(Boolean));
for (const token of tokens) apply(classes, token);
if (value !== null || classes.size > 0) value = [...classes].join(" ");
}
return {
setAttribute(name, text) {
if (name === "class") value = String(text);
},
getAttribute(name) {
return name === "class" ? value : null;
},
classList: {
add(...tokens) {
update(tokens, (classes, token) => classes.add(token));
},
remove(...tokens) {
update(tokens, (classes, token) => classes.delete(token));
},
},
};
}
}Ergebnis
card is-loading is-active is-ready card is-active is-ready InvalidCharacterError SyntaxError card is-active is-ready
Führe den Code in einer Browserkonsole aus, um das native `classList` zu verwenden. Das Element wird nicht in das Dokument eingefügt. In Node.js verwendet das Beispiel anstelle des DOM ein lokales Modell für das Attribut `class` und die gezeigten Operationen. Die letzte Zeile zeigt: Nach beiden fehlgeschlagenen Aufrufen fehlt `pending` weiterhin, und `card` ist noch vorhanden.
Zugehörige Lektionen
- JavaScript · Lektion 1 · Fortgeschritten · Version: 4
- JavaScript · Lektion 2 · Fortgeschritten · Version: 4
- JavaScript · Lektion 3 · Fortgeschritten · Version: 4
- JavaScript · Lektion 4 · Fortgeschritten · Version: 4
- JavaScript · Lektion 5 · Fortgeschritten · Version: 4
- JavaScript · Lektion 6 · Fortgeschritten · Version: 4
- JavaScript · Lektion 8 · Fortgeschritten · Version: 4
- JavaScript · Lektion 12 · Fortgeschritten · Version: 4
- JavaScript · Lektion 13 · Fortgeschritten · Version: 4
- JavaScript · Lektion 16 · Fortgeschritten · Version: 4
- JavaScript · Lektion 18 · Fortgeschritten · Version: 4
- JavaScript · Lektion 19 · Fortgeschritten · Version: 4
- JavaScript · Lektion 22 · Fortgeschritten · Version: 4
- JavaScript · Lektion 23 · Fortgeschritten · Version: 4
- JavaScript · Lektion 26 · Fortgeschritten · Version: 4
- JavaScript · Lektion 28 · Fortgeschritten · Version: 4
- JavaScript · Lektion 29 · Fortgeschritten · Version: 4
- JavaScript · Lektion 32 · Fortgeschritten · Version: 4
- JavaScript · Lektion 33 · Fortgeschritten · Version: 4
- JavaScript · Lektion 36 · Fortgeschritten · Version: 4
- JavaScript · Lektion 37 · Fortgeschritten · Version: 4
- JavaScript · Lektion 39 · Fortgeschritten · Version: 4
- JavaScript · Lektion 40 · Fortgeschritten · Version: 4
- JavaScript · Lektion 41 · Fortgeschritten · Version: 4
- JavaScript · Lektion 45 · Fortgeschritten · Version: 4
- JavaScript · Lektion 27 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 28 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 29 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 30 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 35 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 38 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 39 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 41 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 42 · Mittlere Stufe · Version: 3