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

CKTIS / JavaScript

DOMTokenList: preverjanje in preklapljanje žetonov

`contains()` preveri prisotnost žetona, ne da bi spremenil seznam. `toggle()` prisotnost preklopi ali jo nastavi z `force` in vrne, ali je žeton po klicu prisoten.

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

Sintaksa

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

element.classList vrne DOMTokenList, ki sproti odraža vrednost atributa class elementa. Ti metodi sta del API-ja DOM, ne standarda ECMAScript 2024. Podpora je odvisna od izvajalnega okolja. V brskalniku primer uporablja vgrajeni DOM, v okolju Node.js pa poenostavljen nadomestek za veljavne žetone iz primera.

tokens.contains(token) vrne true, če je na seznamu natanko ta žeton, sicer false. Metoda ne spremeni seznama, razlikuje med velikimi in malimi črkami ter ne išče podnizov. Za prazen niz ali niz z belim znakom ASCII vrne false.

tokens.toggle(token) doda manjkajoči žeton ali odstrani prisotnega. tokens.toggle(token, true) zagotovi njegovo prisotnost, tokens.toggle(token, false) pa odsotnost. Vrnjena vrednost pove, ali je žeton po klicu prisoten, ne pa, ali se je kaj spremenilo. Če naj bo prisotnost razreda odvisna od logičnega pogoja, uporabi tokens.toggle(token, condition). Če za force podaš undefined, je učinek enak, kot če argument izpustiš: tokens.toggle(token, undefined) doda manjkajoči žeton ali odstrani prisotnega. Vsaka druga podana vrednost force se pretvori v logično vrednost: niz "false" postane true, ne false.

toggle() sprejme po en žeton naenkrat. Prazen niz sproži izjemo DOMException z imenom SyntaxError, beli znak ASCII v žetonu pa izjemo DOMException z imenom InvalidCharacterError, tudi če je force nastavljen na false. Podaj ime razreda brez pike iz izbirnika: "active", ne ".active".

Primeri

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

Rezultat

false
true
false
true
true
false
panel

Klica brez `force` najprej dodata in nato odstranita `active`. Oba klica s `true` vrneta `true`, čeprav drugi ničesar ne spremeni. Klic s `false` odstrani `active`, zato ostane samo `panel`.

Povezane lekcije

  • JavaScript · Lekcija 31 · Srednja · Različica: 3

Viri