CKTIS / JavaScript
DOMTokenList: tokens toevoegen, verwijderen en omschakelen
Wijzig afzonderlijke tokens met `add()`, `remove()` en `toggle()`. Gebruik `force` als een voorwaarde moet bepalen of een token aanwezig is.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList geeft toegang tot een DOMTokenList: een live verzameling unieke, hoofdlettergevoelige tokens. Wijzigingen in de lijst werken het class-attribuut bij. Wijzigingen aan het attribuut zijn ook via een eerder opgeslagen verwijzing naar de lijst zichtbaar. Deze methoden horen bij de DOM-API, niet bij ECMAScript; de uitvoeromgeving moet de benodigde DOM-API’s bieden.
add() voegt de opgegeven tokens toe zonder duplicaten te maken. remove() verwijdert de opgegeven tokens en negeert tokens die ontbreken. Beide methoden accepteren meerdere tokens als afzonderlijke argumenten en geven undefined terug.
toggle(token) keert de toestand van één token om: het voegt een ontbrekend token toe of verwijdert een aanwezig token. Bij toggle(token, force) zorgt true ervoor dat het token aanwezig is en false dat het afwezig is. Beide vormen geven terug of het token na de aanroep aanwezig is, niet of er iets is veranderd. Gebruik toggle(token, voorwaarde) als de aanwezigheid van het token een booleaanse voorwaarde moet volgen.
Bij alle drie de methoden veroorzaakt een leeg token een DOMException met de naam SyntaxError. Een token met ASCII-witruimte veroorzaakt een DOMException met de naam InvalidCharacterError. Gebruik list.add("a", "b"), niet list.add("a b"): argumenten worden niet in tokens opgesplitst.
Voorbeelden
{
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"));
}Resultaat
true false true false card ready
Voer de code uit in de browserconsole. Het element wordt niet aan de pagina toegevoegd. De eerste twee resultaten tonen dat `active` wordt toegevoegd en verwijderd. De volgende twee tonen dat `ready` aanwezig is en `active` afwezig blijft. De laatste regel bevat de waarde van het `class`-attribuut.
Gerelateerde lessen
- JavaScript · Les 7 · Gevorderd · Versie: 4
- JavaScript · Les 32 · Gemiddeld · Versie: 3
- JavaScript · Les 34 · Gemiddeld · Versie: 3
- JavaScript · Les 43 · Gemiddeld · Versie: 3