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.