Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

DOMTokenList: dodajanje, odstranjevanje in preklapljanje žetonov

Posamezne žetone spreminjajte z metodami `add()`, `remove()` in `toggle()`. Uporabite `force`, kadar naj o prisotnosti žetona odloča pogoj.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

element.classList omogoča dostop do DOMTokenList: žive množice enoličnih žetonov, ki razlikuje med velikimi in malimi črkami. Sprememba seznama posodobi atribut class, spremembe atributa pa so vidne tudi prek prej shranjene reference na seznam. Te metode so del API-ja DOM, ne ECMAScripta; izvajalno okolje mora zagotavljati potrebne API-je DOM.

add() doda navedene žetone, ne da bi ustvaril dvojnike. remove() odstrani navedene žetone in prezre tiste, ki jih ni na seznamu. Obe metodi sprejmeta več žetonov kot ločene argumente in vrneta undefined.

toggle(token) obrne stanje enega žetona: doda ga, če manjka, ali ga odstrani, če je prisoten. Pri toggle(token, force) vrednost true zagotovi prisotnost žetona, false pa odsotnost. Obe obliki vrneta podatek o tem, ali je žeton po klicu prisoten, ne pa o tem, ali se je kaj spremenilo. Uporabite toggle(token, pogoj), če naj prisotnost žetona sledi logičnemu pogoju.

Pri vseh treh metodah prazen žeton sproži izjemo DOMException z imenom SyntaxError. Žeton, ki vsebuje presledkovni znak ASCII, sproži DOMException z imenom InvalidCharacterError. Uporabite list.add("a", "b"), ne list.add("a b"): argumenti se ne razdelijo na žetone.

Primeri

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

Rezultat

true
false
true
false
card ready

Kodo zaženite v konzoli brskalnika. Element ni vstavljen na stran. Prva dva izpisa kažeta dodajanje in odstranjevanje žetona `active`. Naslednja dva kažeta, da je `ready` prisoten in da `active` še vedno manjka. Zadnja vrstica vsebuje vrednost atributa `class`.

Povezane lekcije

  • JavaScript · Lekcija 7 · Napredna · Različica: 4
  • JavaScript · Lekcija 32 · Srednja · Različica: 3
  • JavaScript · Lekcija 34 · Srednja · Različica: 3
  • JavaScript · Lekcija 43 · Srednja · Različica: 3

Viri