CKTIS / JavaScript
DOMTokenList.toggle() — prepnutie tokenu
DOMTokenList.toggle() prepína prítomnosť tokenu alebo ju vynúti pomocou force. Vráti informáciu o tom, či je token po zavolaní prítomný.
Verzia: 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() pracuje so zoznamom tokenov, napríklad element.classList. Bez argumentu force pridá neprítomný token alebo odstráni prítomný token. Odovzdajte jeden token, nie viacero tried oddelených medzerami.
Pri nastavení force na true sa zabezpečí prítomnosť tokenu; pri hodnote false jeho neprítomnosť. Opakovanie tej istej vynútenej operácie stav neobráti. Výsledkom je true, ak je token po zavolaní prítomný, alebo false, ak chýba. Výsledok nehovorí, či nastala zmena.
Prázdny token vyvolá DOMException s názvom SyntaxError; medzery ASCII v tokene spôsobia InvalidCharacterError. Ide o API DOM, nie o vstavanú funkciu ECMAScriptu. Príklad vyžaduje DOM v prehliadači.
Prí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ýsledok
[true,false,true,true,false] ""
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.