CKTIS / JavaScript
DOMTokenList: dodavanje, uklanjanje i prebacivanje tokena
Mijenjajte pojedinačne tokene metodama `add()`, `remove()` i `toggle()`. Koristite argument `force` kada uvjet treba odrediti je li token prisutan.
Verzija: 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 daje pristup objektu DOMTokenList: skupu jedinstvenih tokena koji se automatski ažurira i razlikuje velika i mala slova. Promjene popisa ažuriraju atribut class, a promjene atributa vidljive su i preko ranije spremljene reference na popis. Te metode pripadaju API-ju DOM-a, a ne ECMAScriptu; izvršno okruženje mora pružati potrebne API-je DOM-a.
add() dodaje navedene tokene bez stvaranja duplikata. remove() uklanja navedene tokene i zanemaruje one kojih nema. Obje metode prihvaćaju više tokena kao zasebne argumente i vraćaju undefined.
toggle(token) preokreće stanje jednog tokena: dodaje ga ako nedostaje ili ga uklanja ako je prisutan. U pozivu toggle(token, force) vrijednost true osigurava prisutnost tokena, a false njegovu odsutnost. Oba oblika vraćaju podatak o tome je li token prisutan nakon poziva, a ne je li se nešto promijenilo. Upotrijebite toggle(token, uvjet) kada prisutnost tokena treba ovisiti o logičkom uvjetu.
U sve tri metode prazan token izaziva iznimku DOMException naziva SyntaxError. Token koji sadrži bjelinu iz skupa ASCII izaziva DOMException naziva InvalidCharacterError. Upotrijebite list.add("a", "b"), a ne list.add("a b"): argumenti se ne dijele na tokene.
Primjeri
{
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
Pokrenite kôd u konzoli preglednika. Element se ne umeće na stranicu. Prva dva rezultata pokazuju dodavanje i uklanjanje tokena `active`. Sljedeća dva pokazuju da je `ready` prisutan, a da `active` i dalje nedostaje. Posljednji redak sadrži vrijednost atributa `class`.
Povezane lekcije
- JavaScript · Lekcija 7 · Napredno · Verzija: 4
- JavaScript · Lekcija 32 · Srednje · Verzija: 3
- JavaScript · Lekcija 34 · Srednje · Verzija: 3
- JavaScript · Lekcija 43 · Srednje · Verzija: 3