Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła