Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMTokenList — upravljanje tokenima pomoću classList

DOMTokenList predstavlja skup tokena, primjerice klasa elementa dostupnih putem classList. Naučite dodavati, uklanjati, prebacivati i provjeravati tokene bez ručne obrade teksta atributa class.

Verzija: 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 uređeni skup tokena i razlikuje velika i mala slova. U vrijednosti atributa tokene razdvajaju samo bjelinski znakovi iz skupa ASCII. Primjerice, nedjeljivi razmak (U+00A0) može biti dio jednog tokena klase umjesto da razdvaja dvije klase. Čest je primjer element.classList: živi objekt koji odražava atribut class. Promjene popisa ažuriraju atribut, a promjene atributa vidljive su putem istog objekta. To nije JavaScriptov niz.

DOMTokenList.add, pozvan kao tokens.add("card", "active"), dodaje pojedinačne tokene i preskače one koji su već prisutni. DOMTokenList.remove, primjerice tokens.remove("active", "missing"), uklanja navedene tokene; token koji nedostaje ne uzrokuje pogrešku. Obje metode prihvaćaju više argumenata i vraćaju undefined. Klase proslijedite zasebno: tokens.add("card", "active"), a ne tokens.add("card active"). Prazan token u add() uzrokuje DOMException nazvan SyntaxError, dok token koji sadrži bjelinski znak iz skupa ASCII uzrokuje InvalidCharacterError.

DOMTokenList.contains, pozvan kao tokens.contains("active"), vraća true ili false bez promjene popisa. DOMTokenList.toggle, pozvan kao tokens.toggle("selected"), dodaje token koji nedostaje ili uklanja prisutni token. Povratna vrijednost pokazuje je li token prisutan nakon operacije, a ne je li došlo do promjene. Oblik tokens.toggle("ready", force) s logičkom vrijednošću true jamči prisutnost tokena, dok false jamči njegovu odsutnost. Taj oblik upotrijebite za usklađivanje s izričitim stanjem umjesto slijepog prebacivanja.

Ovo je DOM API, a ne značajka određenog izdanja ECMAScripta. MDN navodi da su sučelje i četiri ovdje obrađene metode široko dostupni od srpnja 2015.; za starije preglednike provjerite podršku za određene varijante poziva. Prisutnost Node 24 u repozitoriju ne potvrđuje podršku za DOM. Primjer zahtijeva preglednik; element ne mora biti povezan s dokumentom.

Primjeri

{
  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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori