CKTIS / JavaScript
DOMTokenList.toggle() — preklop žetona
DOMTokenList.toggle() preklopi prisotnost žetona ali jo vsili z argumentom force. Vrne podatek o tem, ali je žeton po klicu prisoten.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
tokenList.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() deluje na seznamu žetonov, na primer element.classList. Brez argumenta force doda manjkajoči token ali odstrani prisotnega. Podaj en žeton, ne več razredov, ločenih s presledki.
Če je force nastavljen na true, je prisotnost žetona zagotovljena; pri false je zagotovljena njegova odsotnost. Ponovitev iste vsiljene operacije ne obrne stanja. Rezultat je true, če je žeton po klicu prisoten, ali false, če ga ni. Ne pove, ali se je kaj spremenilo.
Prazen žeton sproži DOMException z imenom SyntaxError; presledki ASCII v žetonu povzročijo InvalidCharacterError. To je API DOM, ne vgrajena funkcija ECMAScript. Primer zahteva DOM v brskalniku.
Primeri
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));Rezultat
[true,false,true,true,false] ""
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.