Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMTokenList: přidávání a odebírání tokenů

Pomocí `add()` a `remove()` měň jednotlivé tokeny, například názvy tříd prvku, bez nahrazení celého atributu. Zjisti, kdy neplatný token způsobí selhání volání.

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

Syntaxe

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

add() a remove() jsou metody instance DOMTokenList, uspořádané množiny jedinečných tokenů, která rozlišuje velká a malá písmena. element.classList vrací seznam průběžně propojený s atributem class: úprava seznamu aktualizuje atribut a změna atributu je vidět i přes dříve uloženou referenci na seznam. DOMTokenList vracejí i jiné vlastnosti, například HTMLLinkElement.relList.

add() připojí chybějící tokeny na konec v pořadí argumentů, aniž vytvoří duplicity. remove() odebere odpovídající tokeny a přeskočí platné tokeny, které v seznamu nejsou. Obě metody přijímají nula nebo více tokenů a při úspěchu vracejí undefined. Bez argumentů zůstávají v množině stejné tokeny, ale při zpětném zápisu atributu se mohou sjednotit mezery a odstranit duplicity z jeho textu.

Každý název třídy předej jako samostatný řetězec: element.classList.add("a", "b"), nikoli element.classList.add("a b"). Použij název třídy ("a"), ne selektor CSS (".a"). Obě metody zkontrolují všechny tokeny, než seznam změní. Prázdný řetězec ("") vyvolá DOMException s názvem SyntaxError; token obsahující bílý znak ASCII, například mezeru nebo tabulátor, vyvolá InvalidCharacterError. V obou případech se nepoužije ani platný token, který byl ve stejném volání uveden dříve.

element.classList.remove() odebírá tokeny, ne samotný prvek. element.remove() odpojí prvek od rodičovského uzlu. DOMTokenList je rozhraní DOM webové platformy, nikoli součást ECMAScriptu 2024. Ověř, že cílové běhové prostředí poskytuje potřebná rozhraní DOM.

Příklady

{
  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));
        },
      },
    };
  }
}

Výsledek

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

Spusť kód v konzoli prohlížeče, pokud chceš použít nativní vlastnost `classList`. Prvek se do dokumentu nevkládá. V Node.js příklad místo DOM používá místní model atributu `class` a předvedených operací. Poslední řádek ukazuje, že po obou neúspěšných voláních `pending` stále chybí a `card` zůstává.

Související lekce

  • JavaScript · Lekce 1 · Pokročilá · Verze: 4
  • JavaScript · Lekce 2 · Pokročilá · Verze: 4
  • JavaScript · Lekce 3 · Pokročilá · Verze: 4
  • JavaScript · Lekce 4 · Pokročilá · Verze: 4
  • JavaScript · Lekce 5 · Pokročilá · Verze: 4
  • JavaScript · Lekce 6 · Pokročilá · Verze: 4
  • JavaScript · Lekce 8 · Pokročilá · Verze: 4
  • JavaScript · Lekce 12 · Pokročilá · Verze: 4
  • JavaScript · Lekce 13 · Pokročilá · Verze: 4
  • JavaScript · Lekce 16 · Pokročilá · Verze: 4
  • JavaScript · Lekce 18 · Pokročilá · Verze: 4
  • JavaScript · Lekce 19 · Pokročilá · Verze: 4
  • JavaScript · Lekce 22 · Pokročilá · Verze: 4
  • JavaScript · Lekce 23 · Pokročilá · Verze: 4
  • JavaScript · Lekce 26 · Pokročilá · Verze: 4
  • JavaScript · Lekce 28 · Pokročilá · Verze: 4
  • JavaScript · Lekce 29 · Pokročilá · Verze: 4
  • JavaScript · Lekce 32 · Pokročilá · Verze: 4
  • JavaScript · Lekce 33 · Pokročilá · Verze: 4
  • JavaScript · Lekce 36 · Pokročilá · Verze: 4
  • JavaScript · Lekce 37 · Pokročilá · Verze: 4
  • JavaScript · Lekce 39 · Pokročilá · Verze: 4
  • JavaScript · Lekce 40 · Pokročilá · Verze: 4
  • JavaScript · Lekce 41 · Pokročilá · Verze: 4
  • JavaScript · Lekce 45 · Pokročilá · Verze: 4
  • JavaScript · Lekce 27 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 28 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 29 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 30 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 35 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 38 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 39 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 41 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 42 · Středně pokročilá · Verze: 3

Zdroje