CKTIS / JavaScript
DOMTokenList: dodawanie, usuwanie i przełączanie tokenów
Zmieniaj poszczególne tokeny za pomocą `add()`, `remove()` i `toggle()`. Użyj argumentu `force`, gdy obecność tokenu ma zależeć od warunku.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList udostępnia DOMTokenList: żywy zbiór unikatowych tokenów, który rozróżnia wielkość liter. Zmiany na liście aktualizują atrybut class, a zmiany atrybutu są widoczne także przez wcześniej zapisaną referencję do listy. To API DOM, nie część ECMAScript; środowisko uruchomieniowe musi udostępniać odpowiednie API DOM.
add() dodaje podane tokeny bez tworzenia duplikatów, a remove() usuwa podane tokeny, ignorując te, których nie ma na liście. Obie metody przyjmują wiele tokenów jako osobne argumenty i zwracają undefined.
toggle(token) odwraca stan jednego tokenu: dodaje go, jeśli go nie ma, lub usuwa, jeśli jest. W wywołaniu toggle(token, force) wartość true zapewnia obecność tokenu, a false — jego brak. W obu postaciach wynik wskazuje, czy token jest obecny po wywołaniu, a nie czy lista się zmieniła. Użyj toggle(token, warunek), gdy obecność tokenu ma odpowiadać warunkowi logicznemu.
We wszystkich trzech metodach pusty token powoduje zgłoszenie wyjątku DOMException o nazwie SyntaxError, a token zawierający biały znak ASCII — DOMException o nazwie InvalidCharacterError. Przekaż list.add("a", "b"), nie list.add("a b"): argumenty nie są dzielone na tokeny.
Przykłady
{
function createExampleElement() {
if (typeof document !== "undefined") {
return document.createElement("div");
}
// Without a DOM, model only the operations used here with valid tokens.
const tokens = new Set();
return {
classList: {
add(...values) {
for (const value of values) tokens.add(value);
},
remove(...values) {
for (const value of values) tokens.delete(value);
},
toggle(value, force = !tokens.has(value)) {
if (force) tokens.add(value);
else tokens.delete(value);
return tokens.has(value);
}
},
getAttribute(name) {
return name === "class" ? [...tokens].join(" ") : null;
}
};
}
const element = createExampleElement();
const list = element.classList;
list.add("card", "pending", "card");
list.remove("pending", "missing");
console.log(list.toggle("active"));
console.log(list.toggle("active"));
console.log(list.toggle("ready", true));
console.log(list.toggle("active", false));
console.log(element.getAttribute("class"));
}Wynik
true false true false card ready
Uruchom kod w konsoli przeglądarki. Element nie jest dołączany do strony. Dwa pierwsze wyniki pokazują dodanie i usunięcie `active`, a dwa następne — że `ready` jest obecny, a `active` pozostaje nieobecny. Ostatni wiersz zawiera wartość atrybutu `class`.
Powiązane lekcje
- JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 32 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 43 · Średniozaawansowany · Wersja: 3