Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje