CKTIS / JavaScript
DOMTokenList: Tokens prüfen und umschalten
`contains()` prüft, ob ein Token vorhanden ist, ohne die Liste zu ändern. `toggle()` kehrt den Zustand um oder setzt ihn mit `force` und meldet, ob das Token danach vorhanden ist.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList liefert eine DOMTokenList, die stets den aktuellen Stand des Attributs class widerspiegelt. Diese Methoden gehören zur DOM-API, nicht zu ECMAScript 2024. Die Unterstützung hängt von der Laufzeitumgebung ab. Im Browser nutzt das Beispiel das native DOM, in Node.js eine vereinfachte Ersatzimplementierung für die gezeigten gültigen Tokens.
tokens.contains(token) gibt true zurück, wenn genau dieses Token vorhanden ist, sonst false. Die Methode ändert die Liste nicht, unterscheidet Groß- und Kleinschreibung und sucht nicht nach Teilzeichenfolgen. Bei einer leeren Zeichenfolge oder einer Zeichenfolge mit ASCII-Leerraum gibt sie false zurück.
tokens.toggle(token) fügt ein fehlendes Token hinzu oder entfernt ein vorhandenes. tokens.toggle(token, true) stellt sicher, dass es vorhanden ist; tokens.toggle(token, false) stellt sicher, dass es fehlt. Der Rückgabewert sagt, ob es danach vorhanden ist, nicht ob sich etwas geändert hat. Um eine Klasse an eine boolesche Bedingung zu koppeln, verwende tokens.toggle(token, condition). undefined für force zu übergeben hat denselben Effekt, wie das Argument wegzulassen: tokens.toggle(token, undefined) kehrt den Zustand des Tokens um. Jeder andere übergebene force-Wert wird in einen booleschen Wert umgewandelt: Die Zeichenfolge "false" wird zu true, nicht zu false.
toggle() verarbeitet jeweils ein Token. Bei einer leeren Zeichenfolge löst die Methode eine DOMException namens SyntaxError aus, bei ASCII-Leerraum im Token eine DOMException namens InvalidCharacterError, auch wenn force den Wert false hat. Übergib den Klassennamen ohne Selektorpunkt: "active", nicht ".active".
Beispiele
{
function createExampleElement(initialClass) {
if (typeof document !== "undefined") {
const element = document.createElement("div");
element.className = initialClass;
return element;
}
// Node.js has no browser DOM. This stand-in handles the valid tokens used below.
const classes = new Set([initialClass]);
return {
get className() {
return [...classes].join(" ");
},
classList: {
contains(token) {
return classes.has(token);
},
toggle(token, force) {
const present = force === undefined ? !classes.has(token) : Boolean(force);
if (present) classes.add(token);
else classes.delete(token);
return present;
},
},
};
}
const element = createExampleElement("panel");
const tokens = element.classList;
console.log(tokens.contains("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", false));
console.log(element.className);
}Ergebnis
false true false true true false panel
Die beiden Aufrufe ohne `force` fügen `active` zuerst hinzu und entfernen es dann. Beide Aufrufe mit `true` geben `true` zurück, obwohl der zweite nichts ändert. Der Aufruf mit `false` entfernt `active`, sodass nur `panel` übrig bleibt.
Zugehörige Lektionen
- JavaScript · Lektion 31 · Mittlere Stufe · Version: 3