CKTIS / JavaScript
DOMTokenList.toggle() — přepnutí tokenu
DOMTokenList.toggle() přepíná přítomnost tokenu nebo ji vynutí pomocí force. Vrací informaci o tom, zda je token po zavolání přítomen.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
tokenList.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() pracuje se seznamem tokenů, například element.classList. Bez argumentu force přidá nepřítomný token nebo odebere přítomný token. Předávejte jeden token, nikoli několik tříd oddělených mezerami.
Při nastavení force na true se zajistí přítomnost tokenu; při hodnotě false jeho nepřítomnost. Opakování stejné vynucené operace stav neobrátí. Výsledkem je true, pokud je token po zavolání přítomen, nebo false, pokud chybí. Výsledek neříká, zda došlo ke změně.
Prázdný token vyvolá DOMException s názvem SyntaxError; mezery ASCII v tokenu způsobí InvalidCharacterError. Jde o API DOM, nikoli o vestavěnou funkci ECMAScriptu. Příklad vyžaduje DOM v prohlížeči.
Příklady
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));Výsledek
[true,false,true,true,false] ""
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.