Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMTokenList: dodavanje i uklanjanje tokena

Metodama `add()` i `remove()` mijenjaj pojedinačne tokene, primjerice nazive klasa elementa, bez zamjene cijelog atributa. Saznaj kada nevaljani token uzrokuje neuspjeh poziva.

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

Sintaksa

tokenList.add(...tokens);
tokenList.remove(...tokens);

add() i remove() metode su instance sučelja DOMTokenList, uređenog skupa jedinstvenih tokena koji razlikuje velika i mala slova. element.classList vraća popis povezan s atributom class: promjena popisa ažurira atribut, a promjena atributa vidljiva je i preko prethodno spremljene reference na popis. DOMTokenList vraćaju i druga svojstva, primjerice HTMLLinkElement.relList.

add() dodaje tokene koji nedostaju na kraj, redoslijedom argumenata i bez stvaranja duplikata. remove() uklanja podudarne tokene i zanemaruje valjane tokene koji nisu na popisu. Obje metode prihvaćaju nula ili više tokena i pri uspješnom pozivu vraćaju undefined. Bez argumenata skup tokena ostaje isti, ali ponovni zapis atributa može ujednačiti razmake i ukloniti duplikate iz njegova teksta.

Svaki naziv klase proslijedi kao zaseban niz znakova: element.classList.add("a", "b"), a ne element.classList.add("a b"). Upotrijebi naziv klase ("a"), a ne CSS selektor (".a"). Obje metode provjeravaju sve tokene prije promjene popisa. Prazan niz znakova ("") izaziva DOMException s nazivom SyntaxError; token koji sadrži ASCII bjelinu, poput razmaka ili tabulatora, izaziva InvalidCharacterError. U oba slučaja ne primjenjuje se ni valjani token naveden ranije u istom pozivu.

element.classList.remove() uklanja tokene, a ne sam element. element.remove() odvaja element od nadređenog čvora. DOMTokenList je DOM sučelje web-platforme, a ne dio ECMAScripta 2024. Provjeri pruža li ciljno izvršno okruženje potrebna DOM sučelja.

Primjeri

{
  const card = typeof document === "undefined"
    ? createClassOnlyCard()
    : document.createElement("div");
  card.setAttribute("class", "card is-loading");
  const tokens = card.classList;

  tokens.add("is-active", "is-ready", "is-active");
  console.log(card.getAttribute("class"));

  tokens.remove("is-loading", "missing");
  console.log(card.getAttribute("class"));

  try {
    tokens.add("pending", "two words");
  } catch (error) {
    console.log(error.name);
  }

  try {
    tokens.remove("card", "");
  } catch (error) {
    console.log(error.name);
  }

  console.log(card.getAttribute("class"));

  // Without a DOM, model only the class attribute and the operations used here.
  function createClassOnlyCard() {
    let value = null;
    const asciiWhitespace = /[\t\n\f\r ]+/;

    function update(tokens, apply) {
      for (const token of tokens) {
        if (token === "") {
          throw new DOMException("A token must not be empty.", "SyntaxError");
        }
        if (asciiWhitespace.test(token)) {
          throw new DOMException("A token must not contain ASCII whitespace.", "InvalidCharacterError");
        }
      }

      const classes = new Set((value ?? "").split(asciiWhitespace).filter(Boolean));
      for (const token of tokens) apply(classes, token);
      if (value !== null || classes.size > 0) value = [...classes].join(" ");
    }

    return {
      setAttribute(name, text) {
        if (name === "class") value = String(text);
      },
      getAttribute(name) {
        return name === "class" ? value : null;
      },
      classList: {
        add(...tokens) {
          update(tokens, (classes, token) => classes.add(token));
        },
        remove(...tokens) {
          update(tokens, (classes, token) => classes.delete(token));
        },
      },
    };
  }
}

Rezultat

card is-loading is-active is-ready
card is-active is-ready
InvalidCharacterError
SyntaxError
card is-active is-ready

Pokreni kôd u konzoli preglednika da bi upotrijebio ugrađeno svojstvo `classList`. Element se ne umeće u dokument. U okruženju Node.js primjer umjesto DOM-a koristi lokalni model atributa `class` i prikazanih operacija. Posljednji redak pokazuje da nakon oba neuspjela poziva `pending` i dalje nedostaje, a `card` je i dalje prisutan.

Povezane lekcije

  • JavaScript · Lekcija 1 · Napredno · Verzija: 4
  • JavaScript · Lekcija 2 · Napredno · Verzija: 4
  • JavaScript · Lekcija 3 · Napredno · Verzija: 4
  • JavaScript · Lekcija 4 · Napredno · Verzija: 4
  • JavaScript · Lekcija 5 · Napredno · Verzija: 4
  • JavaScript · Lekcija 6 · Napredno · Verzija: 4
  • JavaScript · Lekcija 8 · Napredno · Verzija: 4
  • JavaScript · Lekcija 12 · Napredno · Verzija: 4
  • JavaScript · Lekcija 13 · Napredno · Verzija: 4
  • JavaScript · Lekcija 16 · Napredno · Verzija: 4
  • JavaScript · Lekcija 18 · Napredno · Verzija: 4
  • JavaScript · Lekcija 19 · Napredno · Verzija: 4
  • JavaScript · Lekcija 22 · Napredno · Verzija: 4
  • JavaScript · Lekcija 23 · Napredno · Verzija: 4
  • JavaScript · Lekcija 26 · Napredno · Verzija: 4
  • JavaScript · Lekcija 28 · Napredno · Verzija: 4
  • JavaScript · Lekcija 29 · Napredno · Verzija: 4
  • JavaScript · Lekcija 32 · Napredno · Verzija: 4
  • JavaScript · Lekcija 33 · Napredno · Verzija: 4
  • JavaScript · Lekcija 36 · Napredno · Verzija: 4
  • JavaScript · Lekcija 37 · Napredno · Verzija: 4
  • JavaScript · Lekcija 39 · Napredno · Verzija: 4
  • JavaScript · Lekcija 40 · Napredno · Verzija: 4
  • JavaScript · Lekcija 41 · Napredno · Verzija: 4
  • JavaScript · Lekcija 45 · Napredno · Verzija: 4
  • JavaScript · Lekcija 27 · Srednje · Verzija: 3
  • JavaScript · Lekcija 28 · Srednje · Verzija: 3
  • JavaScript · Lekcija 29 · Srednje · Verzija: 3
  • JavaScript · Lekcija 30 · Srednje · Verzija: 3
  • JavaScript · Lekcija 35 · Srednje · Verzija: 3
  • JavaScript · Lekcija 38 · Srednje · Verzija: 3
  • JavaScript · Lekcija 39 · Srednje · Verzija: 3
  • JavaScript · Lekcija 41 · Srednje · Verzija: 3
  • JavaScript · Lekcija 42 · Srednje · Verzija: 3

Izvori