Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMTokenList: dodavanje, uklanjanje i prebacivanje tokena

Mijenjajte pojedinačne tokene metodama `add()`, `remove()` i `toggle()`. Koristite argument `force` kada uvjet treba odrediti je li token prisutan.

Verzija: 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 daje pristup objektu DOMTokenList: skupu jedinstvenih tokena koji se automatski ažurira i razlikuje velika i mala slova. Promjene popisa ažuriraju atribut class, a promjene atributa vidljive su i preko ranije spremljene reference na popis. Te metode pripadaju API-ju DOM-a, a ne ECMAScriptu; izvršno okruženje mora pružati potrebne API-je DOM-a.

add() dodaje navedene tokene bez stvaranja duplikata. remove() uklanja navedene tokene i zanemaruje one kojih nema. Obje metode prihvaćaju više tokena kao zasebne argumente i vraćaju undefined.

toggle(token) preokreće stanje jednog tokena: dodaje ga ako nedostaje ili ga uklanja ako je prisutan. U pozivu toggle(token, force) vrijednost true osigurava prisutnost tokena, a false njegovu odsutnost. Oba oblika vraćaju podatak o tome je li token prisutan nakon poziva, a ne je li se nešto promijenilo. Upotrijebite toggle(token, uvjet) kada prisutnost tokena treba ovisiti o logičkom uvjetu.

U sve tri metode prazan token izaziva iznimku DOMException naziva SyntaxError. Token koji sadrži bjelinu iz skupa ASCII izaziva DOMException naziva InvalidCharacterError. Upotrijebite list.add("a", "b"), a ne list.add("a b"): argumenti se ne dijele na tokene.

Primjeri

{
  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

Pokrenite kôd u konzoli preglednika. Element se ne umeće na stranicu. Prva dva rezultata pokazuju dodavanje i uklanjanje tokena `active`. Sljedeća dva pokazuju da je `ready` prisutan, a da `active` i dalje nedostaje. Posljednji redak sadrži vrijednost atributa `class`.

Povezane lekcije

  • JavaScript · Lekcija 7 · Napredno · Verzija: 4
  • JavaScript · Lekcija 32 · Srednje · Verzija: 3
  • JavaScript · Lekcija 34 · Srednje · Verzija: 3
  • JavaScript · Lekcija 43 · Srednje · Verzija: 3

Izvori