Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła