CKTIS / JavaScript
DOMTokenList: pridávanie a odoberanie tokenov
Pomocou `add()` a `remove()` zmeníš jednotlivé tokeny, napríklad názvy tried prvku, bez nahradenia celého atribútu. Zisti, kedy neplatný token spôsobí zlyhanie volania.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
tokenList.add(...tokens);
tokenList.remove(...tokens);add() a remove() sú metódy inštancie DOMTokenList, usporiadanej množiny jedinečných tokenov, ktorá rozlišuje veľké a malé písmená. element.classList vracia zoznam prepojený s atribútom class: úprava zoznamu aktualizuje atribút a zmena atribútu je viditeľná aj cez predtým uloženú referenciu na zoznam. DOMTokenList vracajú aj iné vlastnosti, napríklad HTMLLinkElement.relList.
add() pripojí chýbajúce tokeny na koniec v poradí argumentov bez vytvorenia duplikátov. remove() odoberie zhodné tokeny a preskočí platné tokeny, ktoré v zozname nie sú. Obe metódy prijímajú nula alebo viac tokenov a pri úspechu vracajú undefined. Bez argumentov zostávajú v množine tie isté tokeny, ale pri spätnom zápise atribútu sa môžu zjednotiť medzery a odstrániť duplikáty z jeho textu.
Každý názov triedy odovzdaj ako samostatný reťazec: element.classList.add("a", "b"), nie element.classList.add("a b"). Použi názov triedy ("a"), nie selektor CSS (".a"). Obe metódy skontrolujú všetky tokeny pred zmenou zoznamu. Prázdny reťazec ("") vyvolá DOMException s názvom SyntaxError; token s bielym znakom ASCII, napríklad medzerou alebo tabulátorom, vyvolá InvalidCharacterError. V oboch prípadoch sa nepoužije ani platný token uvedený skôr v tom istom volaní.
element.classList.remove() odoberá tokeny, nie samotný prvok. element.remove() odpojí prvok od rodičovského uzla. DOMTokenList je rozhranie DOM webovej platformy, nie súčasť ECMAScriptu 2024. Over, či cieľové prostredie poskytuje potrebné rozhrania DOM.
Príklady
{
const card = typeof document === "undefined"
? createClassOnlyCard()
: document.createElement("div");
card.setAttribute("class", "card is-loading");
const tokens = card.classList;
tokens.add("is-active", "is-ready", "is-active");
console.log(card.getAttribute("class"));
tokens.remove("is-loading", "missing");
console.log(card.getAttribute("class"));
try {
tokens.add("pending", "two words");
} catch (error) {
console.log(error.name);
}
try {
tokens.remove("card", "");
} catch (error) {
console.log(error.name);
}
console.log(card.getAttribute("class"));
// Without a DOM, model only the class attribute and the operations used here.
function createClassOnlyCard() {
let value = null;
const asciiWhitespace = /[\t\n\f\r ]+/;
function update(tokens, apply) {
for (const token of tokens) {
if (token === "") {
throw new DOMException("A token must not be empty.", "SyntaxError");
}
if (asciiWhitespace.test(token)) {
throw new DOMException("A token must not contain ASCII whitespace.", "InvalidCharacterError");
}
}
const classes = new Set((value ?? "").split(asciiWhitespace).filter(Boolean));
for (const token of tokens) apply(classes, token);
if (value !== null || classes.size > 0) value = [...classes].join(" ");
}
return {
setAttribute(name, text) {
if (name === "class") value = String(text);
},
getAttribute(name) {
return name === "class" ? value : null;
},
classList: {
add(...tokens) {
update(tokens, (classes, token) => classes.add(token));
},
remove(...tokens) {
update(tokens, (classes, token) => classes.delete(token));
},
},
};
}
}Výsledok
card is-loading is-active is-ready card is-active is-ready InvalidCharacterError SyntaxError card is-active is-ready
Spusť kód v konzole prehliadača, ak chceš použiť natívnu vlastnosť `classList`. Prvok sa nevkladá do dokumentu. V Node.js príklad namiesto DOM používa lokálny model atribútu `class` a ukázaných operácií. Posledný riadok ukazuje, že po oboch neúspešných volaniach `pending` stále chýba a `card` zostáva.
Súvisiace lekcie
- JavaScript · Lekcia 1 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 2 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 3 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 4 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 5 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 6 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 8 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 12 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 13 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 16 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 18 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 19 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 22 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 23 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 26 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 28 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 29 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 32 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 33 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 36 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 37 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 39 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 40 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 41 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 45 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 28 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 29 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 30 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 38 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 39 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 41 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 42 · Stredne pokročilá · Verzia: 3