CKTIS / JavaScript
DOMTokenList: tokens controleren en omschakelen
`contains()` controleert of een token aanwezig is zonder de lijst te wijzigen. `toggle()` wisselt de toestand om of stelt die in met `force` en geeft aan of het token daarna aanwezig is.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList geeft een DOMTokenList die steeds de actuele inhoud van het attribuut class van het element weergeeft. Deze methoden horen bij de DOM-API, niet bij ECMAScript 2024. Ondersteuning hangt af van de uitvoeringsomgeving. In een browser gebruikt het voorbeeld de ingebouwde DOM; in Node.js gebruikt het een vereenvoudigde vervanging voor de getoonde geldige tokens.
tokens.contains(token) retourneert true als het exacte token aanwezig is, anders false. De methode wijzigt de lijst niet, is hoofdlettergevoelig en zoekt niet naar deeltekenreeksen. Een lege tekenreeks of een tekenreeks met ASCII-witruimte geeft false.
tokens.toggle(token) voegt een ontbrekend token toe of verwijdert een aanwezig token. tokens.toggle(token, true) zorgt dat het aanwezig is; tokens.toggle(token, false) zorgt dat het afwezig is. De retourwaarde geeft aan of het token na de aanroep aanwezig is, niet of er iets is gewijzigd. Gebruik tokens.toggle(token, condition) om een klasse van een booleaanse voorwaarde te laten afhangen. undefined doorgeven als force heeft hetzelfde effect als het argument weglaten: tokens.toggle(token, undefined) voegt het token toe als het ontbreekt en verwijdert het als het aanwezig is. Elke andere opgegeven force-waarde wordt omgezet naar een booleaanse waarde: de tekenreeks "false" wordt true, niet false.
toggle() accepteert één token per keer. Een lege tekenreeks veroorzaakt een DOMException met de naam SyntaxError; ASCII-witruimte in het token veroorzaakt een DOMException met de naam InvalidCharacterError, ook als force gelijk is aan false. Geef de klassenaam zonder de punt van de selector door: "active", niet ".active".
Voorbeelden
{
function createExampleElement(initialClass) {
if (typeof document !== "undefined") {
const element = document.createElement("div");
element.className = initialClass;
return element;
}
// Node.js has no browser DOM. This stand-in handles the valid tokens used below.
const classes = new Set([initialClass]);
return {
get className() {
return [...classes].join(" ");
},
classList: {
contains(token) {
return classes.has(token);
},
toggle(token, force) {
const present = force === undefined ? !classes.has(token) : Boolean(force);
if (present) classes.add(token);
else classes.delete(token);
return present;
},
},
};
}
const element = createExampleElement("panel");
const tokens = element.classList;
console.log(tokens.contains("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active"));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", true));
console.log(tokens.toggle("active", false));
console.log(element.className);
}Resultaat
false true false true true false panel
De twee aanroepen zonder `force` voegen `active` eerst toe en verwijderen het daarna. Beide aanroepen met `true` retourneren `true`, hoewel de tweede niets wijzigt. De aanroep met `false` verwijdert `active`, zodat alleen `panel` overblijft.
Gerelateerde lessen
- JavaScript · Les 31 · Gemiddeld · Versie: 3