CKTIS / JavaScript
DOMTokenList: provjera i prebacivanje prisutnosti tokena
`contains()` provjerava je li token prisutan bez promjene popisa. `toggle()` preokreće ili postavlja njegovu prisutnost s `force` i vraća je li token nakon poziva prisutan.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
tokens.contains(token)
tokens.toggle(token)
tokens.toggle(token, force)element.classList daje DOMTokenList koji odražava trenutačnu vrijednost atributa class elementa. Te su metode dio DOM API-ja, a ne standarda ECMAScript 2024. Podrška ovisi o okruženju za izvršavanje. U pregledniku primjer koristi ugrađeni DOM, a u Node.js-u pojednostavljenu zamjenu za valjane tokene iz primjera.
tokens.contains(token) vraća true ako je na popisu upravo taj token, a inače false. Ne mijenja popis, razlikuje velika i mala slova i ne traži podnizove. Za prazan niz znakova ili niz koji sadržava ASCII bjeline vraća false.
tokens.toggle(token) dodaje token ako nije prisutan ili ga uklanja ako jest. tokens.toggle(token, true) osigurava njegovu prisutnost, a tokens.toggle(token, false) njegovu odsutnost. Povratna vrijednost govori je li token prisutan nakon poziva, a ne je li se nešto promijenilo. Ako prisutnost klase treba ovisiti o logičkom uvjetu, koristi tokens.toggle(token, condition). Prosljeđivanje vrijednosti undefined kao argumenta force ima isti učinak kao i izostavljanje argumenta: tokens.toggle(token, undefined) dodaje token ako nije prisutan ili ga uklanja ako jest. Svaka druga proslijeđena vrijednost argumenta force pretvara se u logičku vrijednost: niz "false" postaje true, a ne false.
toggle() prihvaća jedan token po pozivu. Prazan niz znakova izaziva iznimku DOMException naziva SyntaxError, a ASCII bjelina u tokenu izaziva DOMException naziva InvalidCharacterError, čak i kad je force jednak false. Proslijedi naziv klase bez točke iz selektora: "active", a ne ".active".
Primjeri
{
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);
}Rezultat
false true false true true false panel
Dva poziva bez `force` prvo dodaju pa uklanjaju `active`. Oba poziva s `true` vraćaju `true`, iako drugi ništa ne mijenja. Poziv s `false` uklanja `active`, pa ostaje samo `panel`.
Povezane lekcije
- JavaScript · Lekcija 31 · Srednje · Verzija: 3