KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList: tokens toevoegen en verwijderen

Gebruik `add()` en `remove()` om losse tokens, zoals de klassenamen van een element, te wijzigen zonder het hele attribuut te vervangen. Lees wanneer een ongeldig token de aanroep laat mislukken.

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

Syntax

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

add() en remove() zijn instantiemethoden van DOMTokenList, een geordende verzameling unieke tokens die onderscheid maakt tussen hoofdletters en kleine letters. element.classList geeft je een lijst die gekoppeld blijft aan het attribuut class: een wijziging in de lijst werkt het attribuut bij, en een wijziging aan het attribuut is ook zichtbaar via een eerder opgeslagen verwijzing naar de lijst. Andere eigenschappen, zoals HTMLLinkElement.relList, geven eveneens een DOMTokenList terug.

add() voegt ontbrekende tokens achteraan toe in de volgorde van de argumenten, zonder duplicaten te maken. remove() verwijdert overeenkomende tokens en negeert geldige tokens die ontbreken. Beide methoden aanvaarden nul of meer tokens en retourneren undefined bij succes. Zonder argumenten blijven dezelfde tokens aanwezig, maar bij het terugschrijven van het attribuut kunnen de witruimte en dubbele vermeldingen in de tekst worden opgeschoond.

Geef elke klassenaam door als een afzonderlijke string: element.classList.add("a", "b"), niet element.classList.add("a b"). Gebruik de klassenaam ("a"), niet een CSS-selector (".a"). Beide methoden controleren alle tokens voordat ze de lijst wijzigen. Een lege string ("") veroorzaakt een DOMException met de naam SyntaxError; een token met ASCII-witruimte, zoals een spatie of tab, veroorzaakt InvalidCharacterError. In beide gevallen wordt zelfs een eerder opgegeven geldig token uit dezelfde aanroep niet toegepast.

element.classList.remove() verwijdert tokens, niet het element zelf. element.remove() koppelt het element los van zijn bovenliggende knooppunt. DOMTokenList is een DOM-interface van het webplatform, geen onderdeel van ECMAScript 2024. Controleer of je doelomgeving de benodigde DOM-API's biedt.

Voorbeelden

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

Resultaat

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

Voer de code uit in een browserconsole om de ingebouwde eigenschap `classList` te gebruiken. Het element wordt niet in het document ingevoegd. In Node.js gebruikt het voorbeeld in plaats van de DOM een lokaal model van het attribuut `class` en de getoonde bewerkingen. De laatste regel laat zien dat na beide mislukte aanroepen `pending` nog steeds ontbreekt en `card` nog steeds aanwezig is.

Gerelateerde lessen

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

Bronnen