CKTIS / JavaScript
DOMTokenList — upravljanje žetonov z classList
DOMTokenList predstavlja množico žetonov, na primer razredov elementa, dostopnih prek classList. Naučite se dodajati, odstranjevati, preklapljati in preverjati žetone, ne da bi ročno obdelovali besedilo atributa class.
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
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList predstavlja urejeno množico žetonov in razlikuje med velikimi in malimi črkami. V vrednosti atributa žetone ločujejo samo beli znaki ASCII. Nedeljivi presledek (U+00A0) je na primer lahko del enega žetona razreda, namesto da bi ločeval dva razreda. Pogost primer je element.classList: živ objekt, ki odraža atribut class. Spremembe seznama posodobijo atribut, spremembe atributa pa so vidne prek istega objekta. To ni polje JavaScript.
DOMTokenList.add, poklican kot tokens.add("card", "active"), doda posamezne žetone in preskoči že prisotne. DOMTokenList.remove, na primer tokens.remove("active", "missing"), odstrani navedene žetone; manjkajoči žeton ne povzroči napake. Obe metodi sprejmeta več argumentov in vrneta undefined. Razrede podajte ločeno: tokens.add("card", "active"), ne pa tokens.add("card active"). Prazen žeton pri add() povzroči DOMException z imenom SyntaxError, žeton, ki vsebuje beli znak ASCII, pa povzroči InvalidCharacterError.
DOMTokenList.contains, uporabljen kot tokens.contains("active"), vrne true ali false, ne da bi spremenil seznam. DOMTokenList.toggle, uporabljen kot tokens.toggle("selected"), doda odsoten žeton ali odstrani prisotnega. Vrnjena vrednost pove, ali je žeton prisoten po operaciji, ne pa, ali je prišlo do spremembe. Oblika tokens.toggle("ready", force) z logično vrednostjo true zagotovi, da je žeton prisoten, false pa zagotovi njegovo odsotnost. To obliko uporabite za usklajevanje z izrecnim stanjem namesto slepega preklapljanja.
To je API DOM, ne funkcija določene izdaje ECMAScripta. MDN označuje vmesnik in štiri tukaj obravnavane metode kot široko dostopne od julija 2015; pri starejših brskalnikih preverite podporo za posamezne različice klica. Prisotnost Node 24 v repozitoriju ne dokazuje podpore za DOM. Primer zahteva brskalnik; elementa ni treba dodati v dokument.
Primeri
{
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);
}Rezultat
true true false card ready
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.