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

CKTIS / JavaScript

DOMTokenList: dodajanje in odstranjevanje žetonov

Z metodama `add()` in `remove()` spremeni posamezne žetone, na primer imena razredov elementa, ne da bi zamenjal celoten atribut. Preveri, kdaj neveljaven žeton povzroči neuspeh klica.

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

Sintaksa

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

add() in remove() sta metodi primerka DOMTokenList, urejene množice enoličnih žetonov, ki razlikuje med velikimi in malimi črkami. element.classList vrne seznam, povezan z atributom class: sprememba seznama posodobi atribut, sprememba atributa pa je vidna tudi prek prej shranjenega sklica na seznam. DOMTokenList vrnejo tudi druge lastnosti, na primer HTMLLinkElement.relList.

add() doda manjkajoče žetone na konec po vrstnem redu argumentov, ne da bi ustvaril dvojnike. remove() odstrani ujemajoče se žetone in prezre veljavne žetone, ki jih ni na seznamu. Obe metodi sprejmeta nič ali več žetonov in ob uspehu vrneta undefined. Brez argumentov množica ostane enaka, vendar se ob ponovnem zapisu atributa lahko poenoti razmik in odstranijo dvojniki iz njegovega besedila.

Vsako ime razreda podaj kot ločen niz: element.classList.add("a", "b"), ne element.classList.add("a b"). Uporabi ime razreda ("a"), ne izbirnika CSS (".a"). Obe metodi preverita vse žetone, preden spremenita seznam. Prazen niz ("") sproži DOMException z imenom SyntaxError; žeton, ki vsebuje beli znak ASCII, na primer presledek ali tabulator, sproži InvalidCharacterError. V obeh primerih se ne upošteva niti veljaven žeton, ki je bil v istem klicu naveden prej.

element.classList.remove() odstrani žetone, ne elementa. element.remove() odklopi element od nadrejenega vozlišča. DOMTokenList je vmesnik DOM spletne platforme in ni del ECMAScripta 2024. Preveri, ali ciljno izvajalno okolje zagotavlja potrebne vmesnike DOM.

Primeri

{
  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

Kodo zaženi v konzoli brskalnika, če želiš uporabiti vgrajeno lastnost `classList`. Element ni vstavljen v dokument. V okolju Node.js primer namesto DOM-a uporablja lokalni model atributa `class` in prikazanih operacij. Zadnja vrstica pokaže, da po obeh neuspelih klicih `pending` še vedno manjka, `card` pa je še vedno prisoten.

Povezane lekcije

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

Viri