Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList: dodawanie i usuwanie tokenów

Używaj `add()` i `remove()`, aby zmieniać wybrane tokeny, na przykład klasy elementu, bez zastępowania całego atrybutu. Dowiedz się, kiedy nieprawidłowy token przerywa wywołanie.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

tokenList.add(...tokens);
tokenList.remove(...tokens);

add() i remove() to metody instancji DOMTokenList, czyli uporządkowanego zbioru unikatowych tokenów, który rozróżnia wielkość liter. element.classList udostępnia listę powiązaną na bieżąco z atrybutem class: zmiana listy aktualizuje atrybut, a zmiana atrybutu jest widoczna także przez zachowaną wcześniej referencję do listy. Inne właściwości, takie jak HTMLLinkElement.relList, również zwracają DOMTokenList.

add() dopisuje brakujące tokeny w kolejności argumentów, bez duplikatów; remove() usuwa pasujące tokeny i pomija poprawne tokeny, których nie ma na liście. Obie metody przyjmują zero lub więcej tokenów i po udanym wywołaniu zwracają undefined. Wywołanie bez argumentów nie zmienia składu zbioru, ale ponowny zapis atrybutu może ujednolicić odstępy i usunąć z jego tekstu powtórzenia.

Każdą nazwę klasy przekaż jako osobny ciąg znaków: element.classList.add("a", "b"), a nie element.classList.add("a b"). Podaj nazwę klasy ("a"), nie selektor CSS (".a"). Obie metody sprawdzają wszystkie tokeny przed zmianą listy. Pusty ciąg ("") powoduje zgłoszenie DOMException o nazwie SyntaxError, a token zawierający biały znak ASCII, np. spację lub tabulator, powoduje zgłoszenie DOMException o nazwie InvalidCharacterError. W obu przypadkach nawet wcześniejszy poprawny token z tego samego wywołania nie zostanie zastosowany.

element.classList.remove() usuwa tokeny, a nie sam element. element.remove() odłącza element od węzła nadrzędnego. DOMTokenList to interfejs DOM platformy webowej, a nie część ECMAScript 2024. Sprawdź, czy środowisko docelowe udostępnia potrzebne API DOM.

Przykłady

{
  const card = typeof document === "undefined"
    ? createClassOnlyCard()
    : document.createElement("div");
  card.setAttribute("class", "card is-loading");
  const tokens = card.classList;

  tokens.add("is-active", "is-ready", "is-active");
  console.log(card.getAttribute("class"));

  tokens.remove("is-loading", "missing");
  console.log(card.getAttribute("class"));

  try {
    tokens.add("pending", "two words");
  } catch (error) {
    console.log(error.name);
  }

  try {
    tokens.remove("card", "");
  } catch (error) {
    console.log(error.name);
  }

  console.log(card.getAttribute("class"));

  // Without a DOM, model only the class attribute and the operations used here.
  function createClassOnlyCard() {
    let value = null;
    const asciiWhitespace = /[\t\n\f\r ]+/;

    function update(tokens, apply) {
      for (const token of tokens) {
        if (token === "") {
          throw new DOMException("A token must not be empty.", "SyntaxError");
        }
        if (asciiWhitespace.test(token)) {
          throw new DOMException("A token must not contain ASCII whitespace.", "InvalidCharacterError");
        }
      }

      const classes = new Set((value ?? "").split(asciiWhitespace).filter(Boolean));
      for (const token of tokens) apply(classes, token);
      if (value !== null || classes.size > 0) value = [...classes].join(" ");
    }

    return {
      setAttribute(name, text) {
        if (name === "class") value = String(text);
      },
      getAttribute(name) {
        return name === "class" ? value : null;
      },
      classList: {
        add(...tokens) {
          update(tokens, (classes, token) => classes.add(token));
        },
        remove(...tokens) {
          update(tokens, (classes, token) => classes.delete(token));
        },
      },
    };
  }
}

Wynik

card is-loading is-active is-ready
card is-active is-ready
InvalidCharacterError
SyntaxError
card is-active is-ready

Uruchom kod w konsoli przeglądarki, aby użyć natywnego `classList`. Element nie jest wstawiany do dokumentu. W Node.js kod korzysta z lokalnego modelu atrybutu `class` i pokazanych operacji zamiast z DOM. Ostatni wiersz pokazuje, że po obu nieudanych wywołaniach `pending` nadal nie ma w atrybucie, a `card` w nim pozostaje.

Powiązane lekcje

  • JavaScript · Lekcja 1 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 2 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 3 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 4 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 5 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 8 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 12 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 13 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 19 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 22 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 23 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 26 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 28 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 29 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 32 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 36 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 39 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 40 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 41 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 29 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 30 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 38 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 41 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 42 · Średniozaawansowany · Wersja: 3

Źródła