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

CKTIS / JavaScript

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

Měňte jednotlivé tokeny pomocí `add()`, `remove()` a `toggle()`. Parametr `force` použijte, když má o přítomnosti tokenu rozhodovat podmínka.

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

Syntaxe

list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)

element.classList zpřístupňuje DOMTokenList: živou množinu jedinečných tokenů, která rozlišuje malá a velká písmena. Změna seznamu aktualizuje atribut class a změny atributu jsou vidět i přes dříve uložený odkaz na seznam. Tyto metody patří k API DOM, nikoli k ECMAScriptu; běhové prostředí musí potřebná API DOM poskytovat.

add() přidává zadané tokeny bez vytváření duplicit. remove() odebírá zadané tokeny a ignoruje ty, které v seznamu nejsou. Obě metody přijímají více tokenů jako samostatné argumenty a vracejí undefined.

toggle(token) obrátí stav jednoho tokenu: chybějící přidá a přítomný odebere. V zápisu toggle(token, force) hodnota true zajistí přítomnost tokenu a false jeho nepřítomnost. Obě varianty vracejí informaci o tom, zda je token po volání přítomen, nikoli zda se něco změnilo. Použijte toggle(token, podminka), pokud má přítomnost tokenu odpovídat booleovské podmínce.

Ve všech třech metodách vyvolá prázdný token výjimku DOMException s názvem SyntaxError. Token obsahující bílý znak ASCII vyvolá DOMException s názvem InvalidCharacterError. Použijte list.add("a", "b"), nikoli list.add("a b"): argumenty se na tokeny nerozdělují.

Příklady

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

Výsledek

true
false
true
false
card ready

Spusťte kód v konzoli prohlížeče. Element se do stránky nevkládá. První dva výsledky ukazují přidání a odebrání `active`. Další dva ukazují, že `ready` je přítomen a `active` nadále chybí. Poslední řádek obsahuje hodnotu atributu `class`.

Související lekce

  • JavaScript · Lekce 7 · Pokročilá · Verze: 4
  • JavaScript · Lekce 32 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 34 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 43 · Středně pokročilá · Verze: 3

Zdroje