CKTIS / JavaScript
DOMTokenList: přidávání, odebírání a přepínání tokenů
Měňte jednotlivé tokeny pomocí `add()`, `remove()` a `toggle()`. Parametr `force` použijte, když má o přítomnosti tokenu rozhodovat podmínka.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList zpřístupňuje DOMTokenList: živou množinu jedinečných tokenů, která rozlišuje malá a velká písmena. Změna seznamu aktualizuje atribut class a změny atributu jsou vidět i přes dříve uložený odkaz na seznam. Tyto metody patří k API DOM, nikoli k ECMAScriptu; běhové prostředí musí potřebná API DOM poskytovat.
add() přidává zadané tokeny bez vytváření duplicit. remove() odebírá zadané tokeny a ignoruje ty, které v seznamu nejsou. Obě metody přijímají více tokenů jako samostatné argumenty a vracejí undefined.
toggle(token) obrátí stav jednoho tokenu: chybějící přidá a přítomný odebere. V zápisu toggle(token, force) hodnota true zajistí přítomnost tokenu a false jeho nepřítomnost. Obě varianty vracejí informaci o tom, zda je token po volání přítomen, nikoli zda se něco změnilo. Použijte toggle(token, podminka), pokud má přítomnost tokenu odpovídat booleovské podmínce.
Ve všech třech metodách vyvolá prázdný token výjimku DOMException s názvem SyntaxError. Token obsahující bílý znak ASCII vyvolá DOMException s názvem InvalidCharacterError. Použijte list.add("a", "b"), nikoli list.add("a b"): argumenty se na tokeny nerozdělují.
Pří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ýsledek
true false true false card ready
Spusťte kód v konzoli prohlížeče. Element se do stránky nevkládá. První dva výsledky ukazují přidání a odebrání `active`. Další dva ukazují, že `ready` je přítomen a `active` nadále chybí. Poslední řádek obsahuje hodnotu atributu `class`.
Související lekce
- JavaScript · Lekce 7 · Pokročilá · Verze: 4
- JavaScript · Lekce 32 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 34 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 43 · Středně pokročilá · Verze: 3