Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri