CKTIS / JavaScript
DOMTokenList — správa tokenov pomocou classList
DOMTokenList predstavuje množinu tokenov, napríklad tried prvku dostupných cez classList. Naučte sa tokeny pridávať, odoberať, prepínať a kontrolovať bez ručného spracovania textu atribútu class.
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
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList predstavuje usporiadanú množinu tokenov a rozlišuje veľkosť písmen. V hodnote atribútu oddeľujú tokeny iba biele znaky ASCII. Napríklad nezalomiteľná medzera (U+00A0) môže byť súčasťou jediného tokenu triedy namiesto toho, aby oddeľovala dve triedy. Bežným príkladom je element.classList: živý objekt, ktorý odráža atribút class. Zmeny zoznamu aktualizujú atribút a zmeny atribútu sú viditeľné cez ten istý objekt. Nie je to pole JavaScriptu.
DOMTokenList.add, volané ako tokens.add("card", "active"), pridáva jednotlivé tokeny a tie, ktoré už sú prítomné, vynecháva. DOMTokenList.remove, napríklad tokens.remove("active", "missing"), odstraňuje zadané tokeny; chýbajúci token nespôsobí chybu. Obe metódy prijímajú viacero argumentov a vracajú undefined. Triedy odovzdávajte samostatne: tokens.add("card", "active"), nie tokens.add("card active"). Prázdny token v add() spôsobí DOMException s názvom SyntaxError, zatiaľ čo token obsahujúci ASCII biely znak spôsobí InvalidCharacterError.
DOMTokenList.contains, použité ako tokens.contains("active"), vracia true alebo false bez zmeny zoznamu. DOMTokenList.toggle, použité ako tokens.toggle("selected"), pridá neprítomný token alebo odstráni prítomný token. Návratová hodnota vyjadruje, či je token prítomný po operácii, nie či nastala zmena. Varianta tokens.toggle("ready", force) s booleovskou hodnotou true zaručí prítomnosť tokenu, zatiaľ čo false zaručí jeho neprítomnosť. Túto variantu použite pri synchronizácii s výslovne určeným stavom namiesto slepého prepínania.
Ide o DOM API, nie o funkciu konkrétneho vydania ECMAScriptu. MDN označuje rozhranie a štyri tu opísané metódy za široko dostupné od júla 2015; pri starších prehliadačoch si overte podporu konkrétnych variantov volania. Prítomnosť Node 24 v repozitári nepotvrdzuje podporu DOM. Príklad vyžaduje prehliadač; prvok nemusí byť pripojený k dokumentu.
Príklady
{
const element = document.createElement("div");
const tokens = element.classList;
tokens.add("card", "active", "card");
console.log(tokens.contains("active"));
tokens.remove("active", "missing");
console.log(tokens.toggle("selected"));
console.log(tokens.toggle("selected", false));
tokens.toggle("ready", true);
console.log(element.className);
}Výsledok
true true false card ready
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.