CKTIS / JavaScript
DOMTokenList.toggle() — ein Token umschalten
DOMTokenList.toggle() schaltet die Anwesenheit eines Tokens um oder erzwingt sie mit force. Die Methode gibt zurück, ob das Token nach dem Aufruf vorhanden ist.
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
tokenList.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() arbeitet mit einer Tokenliste, zum Beispiel element.classList. Ohne force fügt die Methode ein nicht vorhandenes token hinzu oder entfernt ein vorhandenes. Übergebe ein einzelnes Token, nicht mehrere durch Leerzeichen getrennte Klassen.
Mit force auf true wird sichergestellt, dass das Token vorhanden ist; mit false, dass es fehlt. Wird dieselbe erzwungene Operation wiederholt, kehrt sich der Zustand nicht um. Das Ergebnis ist true, wenn das Token danach vorhanden ist, und false, wenn es fehlt. Es gibt nicht an, ob sich etwas geändert hat.
Ein leeres Token löst eine DOMException namens SyntaxError aus; ASCII-Leerraumzeichen im Token verursachen InvalidCharacterError. Dies ist eine DOM-API und keine ECMAScript-eigene Funktion. Das Beispiel benötigt ein Browser-DOM.
Beispiele
const element = document.createElement('div');
const tokens = element.classList;
const results = [
tokens.toggle('active'),
tokens.toggle('active'),
tokens.toggle('active', true),
tokens.toggle('active', true),
tokens.toggle('active', false)
];
console.log(JSON.stringify(results));
console.log(JSON.stringify(element.className));Ergebnis
[true,false,true,true,false] ""
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.