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

CKTIS / JavaScript

DOMTokenList: kontrola a přepínání tokenů

`contains()` ověří přítomnost tokenu, aniž by změnila seznam. `toggle()` přítomnost přepne nebo ji nastaví pomocí `force` a vrátí, zda je token po volání přítomen.

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

Syntaxe

tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)

element.classList poskytuje DOMTokenList, která průběžně odráží aktuální hodnotu atributu class daného prvku. Tyto metody patří do API DOM, nikoli do ECMAScriptu 2024. Podpora závisí na běhovém prostředí. V prohlížeči příklad používá nativní DOM, zatímco v Node.js používá zjednodušenou náhradu pro platné tokeny z příkladu.

tokens.contains(token) vrací true, pokud je v seznamu přesně tento token, jinak false. Seznam nemění, rozlišuje velká a malá písmena a nevyhledává podřetězce. Pro prázdný řetězec nebo řetězec obsahující bílý znak ASCII vrací false.

tokens.toggle(token) přidá chybějící token nebo odstraní přítomný. tokens.toggle(token, true) zajistí jeho přítomnost; tokens.toggle(token, false) zajistí jeho nepřítomnost. Návratová hodnota říká, zda je token po volání přítomen, ne zda se něco změnilo. Chceš-li navázat přítomnost třídy na logickou podmínku, použij tokens.toggle(token, condition). Předání undefined jako force má stejný účinek jako vynechání argumentu: tokens.toggle(token, undefined) přidá chybějící token nebo odstraní přítomný. Každá jiná předaná hodnota force se převede na logickou hodnotu: řetězec "false" se převede na true, nikoli na false.

toggle() přijímá vždy jeden token. Prázdný řetězec vyvolá výjimku DOMException s názvem SyntaxError; bílý znak ASCII v tokenu vyvolá výjimku DOMException s názvem InvalidCharacterError, i když má force hodnotu false. Název třídy předávej bez tečky selektoru: "active", ne ".active".

Příklady

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

Výsledek

false
true
false
true
true
false
panel

Dvě volání bez `force` nejprve přidají a poté odstraní `active`. Obě volání s `true` vrátí `true`, přestože druhé nic nezmění. Volání s `false` odstraní `active`, takže zůstane pouze `panel`.

Související lekce

  • JavaScript · Lekce 31 · Středně pokročilá · Verze: 3

Zdroje