KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList — tokens beheren met classList

DOMTokenList vertegenwoordigt een verzameling tokens, zoals de klassen van een element die via classList beschikbaar zijn. Leer tokens toevoegen, verwijderen, omschakelen en controleren zonder de tekst van het class-attribuut handmatig te verwerken.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);

DOMTokenList vertegenwoordigt een geordende verzameling tokens en maakt onderscheid tussen hoofdletters en kleine letters. In de attribuutwaarde worden tokens alleen door ASCII-witruimte gescheiden. Een vaste spatie (U+00A0) kan bijvoorbeeld deel uitmaken van één klassetoken in plaats van twee klassen te scheiden. Een bekend voorbeeld is element.classList: een live object dat het class-attribuut weerspiegelt. Wijzigingen in de lijst werken het attribuut bij, en wijzigingen in het attribuut zijn zichtbaar via hetzelfde object. Het is geen JavaScript-array.

DOMTokenList.add, aangeroepen als tokens.add("card", "active"), voegt afzonderlijke tokens toe en slaat tokens over die al aanwezig zijn. DOMTokenList.remove, bijvoorbeeld tokens.remove("active", "missing"), verwijdert de opgegeven tokens; een ontbrekend token veroorzaakt geen fout. Beide methoden accepteren meerdere argumenten en retourneren undefined. Geef klassen afzonderlijk door: tokens.add("card", "active"), niet tokens.add("card active"). Bij add() veroorzaakt een leeg token een DOMException met de naam SyntaxError, terwijl een token met ASCII-witruimte InvalidCharacterError veroorzaakt.

DOMTokenList.contains, gebruikt als tokens.contains("active"), retourneert true of false zonder de lijst te wijzigen. DOMTokenList.toggle, gebruikt als tokens.toggle("selected"), voegt een afwezig token toe of verwijdert een aanwezig token. De retourwaarde geeft aan of het token na de bewerking aanwezig is, niet of er een wijziging heeft plaatsgevonden. Met de vorm tokens.toggle("ready", force) en de booleaanse waarde true zorg je dat het token aanwezig is; met false zorg je dat het afwezig is. Gebruik deze vorm om te synchroniseren met een expliciete toestand, in plaats van blind te schakelen.

Dit is een DOM-API, geen functie van een bepaalde ECMAScript-editie. MDN geeft aan dat de interface en de vier hier besproken methoden sinds juli 2015 breed beschikbaar zijn; controleer bij oudere browsers de ondersteuning voor specifieke aanroepvarianten. De aanwezigheid van Node 24 in een repository bewijst geen DOM-ondersteuning. Het voorbeeld vereist een browser; het element hoeft niet aan het document te zijn toegevoegd.

Voorbeelden

{
  const element = document.createElement("div");
  const tokens = element.classList;

  tokens.add("card", "active", "card");
  console.log(tokens.contains("active"));

  tokens.remove("active", "missing");
  console.log(tokens.toggle("selected"));
  console.log(tokens.toggle("selected", false));

  tokens.toggle("ready", true);
  console.log(element.className);
}

Resultaat

true
true
false
card ready

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen