Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMTokenList — správa tokenů pomocí classList

DOMTokenList představuje množinu tokenů, například tříd prvku dostupných přes classList. Naučte se tokeny přidávat, odebírat, přepínat a kontrolovat, aniž byste ručně zpracovávali text atributu class.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);

DOMTokenList představuje uspořádanou množinu tokenů a rozlišuje velikost písmen. V hodnotě atributu oddělují tokeny pouze bílé znaky ASCII. Například nezlomitelná mezera (U+00A0) může být součástí jediného tokenu třídy, místo aby oddělovala dvě třídy. Běžným příkladem je element.classList: živý objekt, který odráží atribut class. Změny seznamu aktualizují atribut a změny atributu jsou viditelné prostřednictvím stejného objektu. Nejde o pole JavaScriptu.

DOMTokenList.add, volané jako tokens.add("card", "active"), přidává jednotlivé tokeny a ty, které už jsou přítomné, vynechává. DOMTokenList.remove, například tokens.remove("active", "missing"), odstraňuje zadané tokeny; chybějící token nezpůsobí chybu. Obě metody přijímají více argumentů a vracejí undefined. Třídy předávejte samostatně: tokens.add("card", "active"), nikoli tokens.add("card active"). Prázdný token v add() způsobí DOMException s názvem SyntaxError, zatímco token obsahující ASCII bílý znak způsobí InvalidCharacterError.

DOMTokenList.contains, použité jako tokens.contains("active"), vrací true nebo false, aniž by seznam měnilo. DOMTokenList.toggle, použité jako tokens.toggle("selected"), přidá nepřítomný token nebo odebere přítomný token. Návratová hodnota udává, zda je token přítomen po operaci, nikoli zda došlo ke změně. Varianta tokens.toggle("ready", force) s booleovskou hodnotou true zaručí přítomnost tokenu, zatímco false zaručí jeho nepřítomnost. Tuto variantu použijte při synchronizaci s výslovně určeným stavem místo slepého přepínání.

Jde o DOM API, nikoli o funkci určitého vydání ECMAScriptu. MDN označuje rozhraní a čtyři zde probírané metody za široce dostupné od července 2015; u starších prohlížečů ověřte podporu konkrétních variant volání. Přítomnost Node 24 v repozitáři nepotvrzuje podporu DOM. Příklad vyžaduje prohlížeč; prvek nemusí být připojen k dokumentu.

Pří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ýsledek

true
true
false
card ready

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje