Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList — zarządzanie tokenami przez classList

DOMTokenList reprezentuje zbiór tokenów, na przykład klas elementu dostępnych przez classList. Poznaj dodawanie, usuwanie, przełączanie i sprawdzanie tokenów bez ręcznego przetwarzania tekstu atrybutu class.

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

Składnia

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

DOMTokenList reprezentuje uporządkowany zbiór tokenów i rozróżnia wielkość liter. W wartości atrybutu separatorami tokenów są wyłącznie białe znaki ASCII. Na przykład spacja nierozdzielająca (U+00A0) może być częścią jednego tokenu klasy, zamiast rozdzielać dwie klasy. Typowym przykładem jest element.classList: żywy obiekt odzwierciedlający atrybut class. Zmiany listy aktualizują atrybut, a zmiany atrybutu są widoczne w tym samym obiekcie. Nie jest to tablica JavaScript.

DOMTokenList.add, wywoływane jako tokens.add("card", "active"), dodaje osobne tokeny i pomija już obecne. DOMTokenList.remove, np. tokens.remove("active", "missing"), usuwa wskazane tokeny; brak tokenu nie powoduje błędu. Obie metody przyjmują wiele argumentów i zwracają undefined. Przekazuj klasy osobno: tokens.add("card", "active"), nie tokens.add("card active"). Dla add() pusty token powoduje DOMException o nazwie SyntaxError, a token zawierający biały znak ASCII — InvalidCharacterError.

DOMTokenList.contains, czyli tokens.contains("active"), zwraca true albo false bez zmiany listy. DOMTokenList.toggle, czyli tokens.toggle("selected"), dodaje nieobecny token lub usuwa obecny. Zwraca informację o obecności tokenu po operacji, a nie o tym, czy nastąpiła zmiana. Wersja tokens.toggle("ready", force) z wartością logiczną true zapewnia obecność tokenu, a z false — jego brak. Używaj jej przy synchronizacji z jawnym stanem zamiast bezwarunkowego przełączania.

To API DOM, a nie funkcja konkretnej edycji ECMAScript. MDN oznacza interfejs i cztery omawiane metody jako szeroko dostępne od lipca 2015; dla starszych przeglądarek sprawdź obsługę konkretnych wariantów wywołania. Obecność Node 24 w repozytorium nie potwierdza obsługi DOM. Przykład wymaga przeglądarki; element nie musi być dołączony do dokumentu.

Przykłady

{
  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);
}

Wynik

true
true
false
card ready

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła