Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DOMTokenList: pridávanie, odoberanie a prepínanie tokenov

Meňte jednotlivé tokeny pomocou `add()`, `remove()` a `toggle()`. Argument `force` použite, keď má o prítomnosti tokenu rozhodovať podmienka.

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

Syntax

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

element.classList sprístupňuje DOMTokenList: živú množinu jedinečných tokenov, ktorá rozlišuje malé a veľké písmená. Zmena zoznamu aktualizuje atribút class a zmeny atribútu vidno aj cez skôr uložený odkaz na zoznam. Tieto metódy patria do API DOM, nie do ECMAScriptu; prostredie, v ktorom kód beží, musí poskytovať potrebné API DOM.

add() pridáva zadané tokeny bez vytvárania duplikátov. remove() odoberá zadané tokeny a ignoruje tie, ktoré v zozname nie sú. Obe metódy prijímajú viac tokenov ako samostatné argumenty a vracajú undefined.

toggle(token) obráti stav jedného tokenu: chýbajúci pridá a prítomný odoberie. Pri toggle(token, force) hodnota true zaručí prítomnosť tokenu a false jeho neprítomnosť. Obe formy vracajú informáciu o tom, či je token po volaní prítomný, nie či sa niečo zmenilo. Použite toggle(token, podmienka), ak má prítomnosť tokenu zodpovedať booleovskej podmienke.

Vo všetkých troch metódach vyvolá prázdny token výnimku DOMException s názvom SyntaxError. Token obsahujúci biely znak ASCII vyvolá DOMException s názvom InvalidCharacterError. Použite list.add("a", "b"), nie list.add("a b"): argumenty sa nerozdeľujú na tokeny.

Prí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ýsledok

true
false
true
false
card ready

Spustite kód v konzole prehliadača. Prvok sa do stránky nevkladá. Prvé dva výsledky ukazujú pridanie a odobratie `active`. Ďalšie dva ukazujú, že `ready` je prítomný a `active` naďalej chýba. Posledný riadok obsahuje hodnotu atribútu `class`.

Súvisiace lekcie

  • JavaScript · Lekcia 7 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 43 · Stredne pokročilá · Verzia: 3

Zdroje