CKTIS / JavaScript
DOMTokenList: sprawdzanie i przełączanie tokenów
`contains()` sprawdza obecność tokenu bez zmiany listy. `toggle()` odwraca jego stan albo ustawia go zgodnie z argumentem `force` i zwraca informację o obecności tokenu po wywołaniu.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList udostępnia DOMTokenList powiązaną na bieżąco z atrybutem class elementu. To interfejs API DOM, a nie część ECMAScript 2024. Obsługa zależy od środowiska wykonawczego. W przeglądarce przykład używa interfejsu DOM, a w Node.js korzysta z uproszczonego zamiennika dla poprawnych tokenów użytych w przykładzie.
tokens.contains(token) zwraca true, jeśli lista zawiera dokładnie ten token, a w przeciwnym razie false. Nie zmienia listy, rozróżnia wielkie i małe litery i nie wyszukuje fragmentów nazw. Dla pustego ciągu lub ciągu z białym znakiem ASCII zwraca false.
tokens.toggle(token) dodaje nieobecny token albo usuwa obecny. tokens.toggle(token, true) zapewnia jego obecność, a tokens.toggle(token, false) jego brak. Wynik mówi, czy token jest obecny po wywołaniu, a nie czy lista się zmieniła. Aby dopasować klasę do warunku logicznego, użyj tokens.toggle(token, condition). Podanie undefined jako force działa tak samo jak pominięcie argumentu: tokens.toggle(token, undefined) odwraca stan tokenu. Każda inna podana wartość force jest konwertowana na wartość logiczną: ciąg "false" daje true, nie false.
toggle() przyjmuje jeden token naraz. Pusty ciąg powoduje zgłoszenie DOMException o nazwie SyntaxError, a biały znak ASCII w tokenie — DOMException o nazwie InvalidCharacterError, także przy force równym false. Przekazuj nazwę klasy bez kropki selektora: "active", nie ".active".
Przykłady
{
function createExampleElement(initialClass) {
if (typeof document !== "undefined") {
const element = document.createElement("div");
element.className = initialClass;
return element;
}
// Node.js has no browser DOM. This stand-in handles the valid tokens used below.
const classes = new Set([initialClass]);
return {
get className() {
return [...classes].join(" ");
},
classList: {
contains(token) {
return classes.has(token);
},
toggle(token, force) {
const present = force === undefined ? !classes.has(token) : Boolean(force);
if (present) classes.add(token);
else classes.delete(token);
return present;
},
},
};
}
const element = createExampleElement("panel");
const tokens = element.classList;
console.log(tokens.contains("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", false));
console.log(element.className);
}Wynik
false true false true true false panel
Dwa wywołania bez `force` najpierw dodają, a potem usuwają `active`. Oba wywołania z `true` zwracają `true`, choć drugie niczego nie zmienia. Wywołanie z `false` usuwa `active`, więc zostaje tylko `panel`.
Powiązane lekcje
- JavaScript · Lekcja 31 · Średniozaawansowany · Wersja: 3