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

CKTIS / JavaScript

DOMTokenList: kontrola a prepínanie tokenov

`contains()` overí prítomnosť tokenu bez zmeny zoznamu. `toggle()` jeho prítomnosť prepne alebo nastaví pomocou `force` a vráti, či je token po volaní prítomný.

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

Syntax

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

element.classList poskytuje DOMTokenList, ktorá priebežne odráža aktuálnu hodnotu atribútu class daného prvku. Tieto metódy patria do API DOM, nie do ECMAScriptu 2024. Podpora závisí od behového prostredia. V prehliadači príklad používa natívny DOM, v Node.js používa zjednodušenú náhradu pre platné tokeny z príkladu.

tokens.contains(token) vráti true, ak je v zozname presne tento token, inak false. Zoznam nemení, rozlišuje veľké a malé písmená a nehľadá podreťazce. Pre prázdny reťazec alebo reťazec obsahujúci biely znak ASCII vráti false.

tokens.toggle(token) pridá chýbajúci token alebo odstráni prítomný. tokens.toggle(token, true) zaručí jeho prítomnosť; tokens.toggle(token, false) zaručí jeho neprítomnosť. Návratová hodnota hovorí, či je token po volaní prítomný, nie či sa niečo zmenilo. Ak má prítomnosť triedy závisieť od logickej podmienky, použi tokens.toggle(token, condition). Odovzdanie undefined ako force má rovnaký účinok ako vynechanie argumentu: tokens.toggle(token, undefined) pridá chýbajúci token alebo odstráni prítomný. Každá iná odovzdaná hodnota force sa prevedie na logickú hodnotu: reťazec "false" sa zmení na true, nie na false.

toggle() prijíma naraz jeden token. Prázdny reťazec vyvolá výnimku DOMException s názvom SyntaxError; biely znak ASCII v tokene vyvolá výnimku DOMException s názvom InvalidCharacterError, aj keď má force hodnotu false. Názov triedy odovzdaj bez bodky selektora: "active", nie ".active".

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

false
true
false
true
true
false
panel

Dve volania bez `force` najprv pridajú a potom odstránia `active`. Obe volania s `true` vrátia `true`, hoci druhé nič nezmení. Volanie s `false` odstráni `active`, takže zostane iba `panel`.

Súvisiace lekcie

  • JavaScript · Lekcia 31 · Stredne pokročilá · Verzia: 3

Zdroje