CKTIS / JavaScript
DOMTokenList: Tokens hinzufügen, entfernen und umschalten
Ändere einzelne Tokens mit `add()`, `remove()` und `toggle()`. Mit `force` legst du fest, dass eine Bedingung über das Vorhandensein eines Tokens entscheidet.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList liefert eine DOMTokenList: eine live aktualisierte Menge eindeutiger Tokens, die Groß- und Kleinschreibung unterscheidet. Änderungen an der Liste aktualisieren das Attribut class; Änderungen am Attribut sind auch über eine zuvor gespeicherte Referenz auf die Liste sichtbar. Die Methoden gehören zur DOM-API, nicht zu ECMAScript. Die Laufzeitumgebung muss die nötigen DOM-APIs bereitstellen.
add() fügt die angegebenen Tokens ohne Duplikate hinzu. remove() entfernt die angegebenen Tokens und ignoriert fehlende Tokens. Beide Methoden nehmen mehrere Tokens als separate Argumente entgegen und geben undefined zurück.
toggle(token) kehrt den Zustand eines Tokens um: Es wird hinzugefügt, wenn es fehlt, und entfernt, wenn es vorhanden ist. Bei toggle(token, force) sorgt true dafür, dass das Token vorhanden ist, und false dafür, dass es fehlt. Beide Varianten geben zurück, ob das Token nach dem Aufruf vorhanden ist, nicht ob sich etwas geändert hat. Verwende toggle(token, bedingung), wenn das Vorhandensein einer booleschen Bedingung folgen soll.
Bei allen drei Methoden löst ein leeres Token eine DOMException namens SyntaxError aus. Enthält ein Token ASCII-Leerraum, heißt die DOMException InvalidCharacterError. Verwende list.add("a", "b"), nicht list.add("a b"): Argumente werden nicht in mehrere Tokens zerlegt.
Beispiele
{
function createExampleElement() {
if (typeof document !== "undefined") {
return document.createElement("div");
}
// Without a DOM, model only the operations used here with valid tokens.
const tokens = new Set();
return {
classList: {
add(...values) {
for (const value of values) tokens.add(value);
},
remove(...values) {
for (const value of values) tokens.delete(value);
},
toggle(value, force = !tokens.has(value)) {
if (force) tokens.add(value);
else tokens.delete(value);
return tokens.has(value);
}
},
getAttribute(name) {
return name === "class" ? [...tokens].join(" ") : null;
}
};
}
const element = createExampleElement();
const list = element.classList;
list.add("card", "pending", "card");
list.remove("pending", "missing");
console.log(list.toggle("active"));
console.log(list.toggle("active"));
console.log(list.toggle("ready", true));
console.log(list.toggle("active", false));
console.log(element.getAttribute("class"));
}Ergebnis
true false true false card ready
Führe den Code in der Browserkonsole aus. Das Element wird nicht in die Seite eingefügt. Die ersten beiden Ergebnisse zeigen, dass `active` hinzugefügt und entfernt wird. Die nächsten beiden zeigen, dass `ready` vorhanden ist und `active` weiterhin fehlt. Die letzte Zeile enthält den Wert des Attributs `class`.
Zugehörige Lektionen
- JavaScript · Lektion 7 · Fortgeschritten · Version: 4
- JavaScript · Lektion 32 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 34 · Mittlere Stufe · Version: 3
- JavaScript · Lektion 43 · Mittlere Stufe · Version: 3