CKTIS / JavaScript
DOMTokenList: pridávanie, odoberanie a prepínanie tokenov
Meňte jednotlivé tokeny pomocou `add()`, `remove()` a `toggle()`. Argument `force` použite, keď má o prítomnosti tokenu rozhodovať podmienka.
Verzia: 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 sprístupňuje DOMTokenList: živú množinu jedinečných tokenov, ktorá rozlišuje malé a veľké písmená. Zmena zoznamu aktualizuje atribút class a zmeny atribútu vidno aj cez skôr uložený odkaz na zoznam. Tieto metódy patria do API DOM, nie do ECMAScriptu; prostredie, v ktorom kód beží, musí poskytovať potrebné API DOM.
add() pridáva zadané tokeny bez vytvárania duplikátov. remove() odoberá zadané tokeny a ignoruje tie, ktoré v zozname nie sú. Obe metódy prijímajú viac tokenov ako samostatné argumenty a vracajú undefined.
toggle(token) obráti stav jedného tokenu: chýbajúci pridá a prítomný odoberie. Pri toggle(token, force) hodnota true zaručí prítomnosť tokenu a false jeho neprítomnosť. Obe formy vracajú informáciu o tom, či je token po volaní prítomný, nie či sa niečo zmenilo. Použite toggle(token, podmienka), ak má prítomnosť tokenu zodpovedať booleovskej podmienke.
Vo všetkých troch metódach vyvolá prázdny token výnimku DOMException s názvom SyntaxError. Token obsahujúci biely znak ASCII vyvolá DOMException s názvom InvalidCharacterError. Použite list.add("a", "b"), nie list.add("a b"): argumenty sa nerozdeľujú na tokeny.
Príklady
{
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"));
}Výsledok
true false true false card ready
Spustite kód v konzole prehliadača. Prvok sa do stránky nevkladá. Prvé dva výsledky ukazujú pridanie a odobratie `active`. Ďalšie dva ukazujú, že `ready` je prítomný a `active` naďalej chýba. Posledný riadok obsahuje hodnotu atribútu `class`.
Súvisiace lekcie
- JavaScript · Lekcia 7 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 43 · Stredne pokročilá · Verzia: 3