Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMTokenList: provjera i prebacivanje prisutnosti tokena

`contains()` provjerava je li token prisutan bez promjene popisa. `toggle()` preokreće ili postavlja njegovu prisutnost s `force` i vraća je li token nakon poziva prisutan.

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

Sintaksa

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

element.classList daje DOMTokenList koji odražava trenutačnu vrijednost atributa class elementa. Te su metode dio DOM API-ja, a ne standarda ECMAScript 2024. Podrška ovisi o okruženju za izvršavanje. U pregledniku primjer koristi ugrađeni DOM, a u Node.js-u pojednostavljenu zamjenu za valjane tokene iz primjera.

tokens.contains(token) vraća true ako je na popisu upravo taj token, a inače false. Ne mijenja popis, razlikuje velika i mala slova i ne traži podnizove. Za prazan niz znakova ili niz koji sadržava ASCII bjeline vraća false.

tokens.toggle(token) dodaje token ako nije prisutan ili ga uklanja ako jest. tokens.toggle(token, true) osigurava njegovu prisutnost, a tokens.toggle(token, false) njegovu odsutnost. Povratna vrijednost govori je li token prisutan nakon poziva, a ne je li se nešto promijenilo. Ako prisutnost klase treba ovisiti o logičkom uvjetu, koristi tokens.toggle(token, condition). Prosljeđivanje vrijednosti undefined kao argumenta force ima isti učinak kao i izostavljanje argumenta: tokens.toggle(token, undefined) dodaje token ako nije prisutan ili ga uklanja ako jest. Svaka druga proslijeđena vrijednost argumenta force pretvara se u logičku vrijednost: niz "false" postaje true, a ne false.

toggle() prihvaća jedan token po pozivu. Prazan niz znakova izaziva iznimku DOMException naziva SyntaxError, a ASCII bjelina u tokenu izaziva DOMException naziva InvalidCharacterError, čak i kad je force jednak false. Proslijedi naziv klase bez točke iz selektora: "active", a ne ".active".

Primjeri

{
  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

Dva poziva bez `force` prvo dodaju pa uklanjaju `active`. Oba poziva s `true` vraćaju `true`, iako drugi ništa ne mijenja. Poziv s `false` uklanja `active`, pa ostaje samo `panel`.

Povezane lekcije

  • JavaScript · Lekcija 31 · Srednje · Verzija: 3

Izvori