CKTIS / JavaScript
DOMTokenList: dodajanje, odstranjevanje in preklapljanje žetonov
Posamezne žetone spreminjajte z metodami `add()`, `remove()` in `toggle()`. Uporabite `force`, kadar naj o prisotnosti žetona odloča pogoj.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList omogoča dostop do DOMTokenList: žive množice enoličnih žetonov, ki razlikuje med velikimi in malimi črkami. Sprememba seznama posodobi atribut class, spremembe atributa pa so vidne tudi prek prej shranjene reference na seznam. Te metode so del API-ja DOM, ne ECMAScripta; izvajalno okolje mora zagotavljati potrebne API-je DOM.
add() doda navedene žetone, ne da bi ustvaril dvojnike. remove() odstrani navedene žetone in prezre tiste, ki jih ni na seznamu. Obe metodi sprejmeta več žetonov kot ločene argumente in vrneta undefined.
toggle(token) obrne stanje enega žetona: doda ga, če manjka, ali ga odstrani, če je prisoten. Pri toggle(token, force) vrednost true zagotovi prisotnost žetona, false pa odsotnost. Obe obliki vrneta podatek o tem, ali je žeton po klicu prisoten, ne pa o tem, ali se je kaj spremenilo. Uporabite toggle(token, pogoj), če naj prisotnost žetona sledi logičnemu pogoju.
Pri vseh treh metodah prazen žeton sproži izjemo DOMException z imenom SyntaxError. Žeton, ki vsebuje presledkovni znak ASCII, sproži DOMException z imenom InvalidCharacterError. Uporabite list.add("a", "b"), ne list.add("a b"): argumenti se ne razdelijo na žetone.
Primeri
{
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"));
}Rezultat
true false true false card ready
Kodo zaženite v konzoli brskalnika. Element ni vstavljen na stran. Prva dva izpisa kažeta dodajanje in odstranjevanje žetona `active`. Naslednja dva kažeta, da je `ready` prisoten in da `active` še vedno manjka. Zadnja vrstica vsebuje vrednost atributa `class`.
Povezane lekcije
- JavaScript · Lekcija 7 · Napredna · Različica: 4
- JavaScript · Lekcija 32 · Srednja · Različica: 3
- JavaScript · Lekcija 34 · Srednja · Različica: 3
- JavaScript · Lekcija 43 · Srednja · Različica: 3