CKTIS / JavaScript
DOMTokenList: добавяне, премахване и превключване на токени
Променяйте отделни токени с `add()`, `remove()` и `toggle()`. Използвайте аргумента `force`, когато дадено условие трябва да определя дали токенът присъства.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
list.add(...tokens)
list.remove(...tokens)
list.toggle(token)
list.toggle(token, force)element.classList предоставя DOMTokenList: динамично множество от уникални токени, което различава главни и малки букви. Промените в списъка обновяват атрибута class, а промените в атрибута се виждат и през по-рано запазена референция към списъка. Тези методи са част от DOM API, а не от ECMAScript; средата за изпълнение трябва да предоставя необходимите DOM API.
add() добавя посочените токени, без да създава дубликати. remove() премахва посочените токени и пропуска липсващите. И двата метода приемат няколко токена като отделни аргументи и връщат undefined.
toggle(token) обръща състоянието на един токен: добавя го, ако липсва, или го премахва, ако присъства. При toggle(token, force) стойността true гарантира присъствие, а false — отсъствие. И двете форми връщат дали токенът присъства след извикването, а не дали е настъпила промяна. Използвайте toggle(token, condition), когато присъствието на токена трябва да следва булево условие.
И при трите метода празен токен предизвиква изключение DOMException с име SyntaxError, а токен, съдържащ знак за празно пространство от набора ASCII — DOMException с име InvalidCharacterError. Използвайте list.add("a", "b"), а не list.add("a b"): аргументите не се разделят на токени.
Примери
{
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"));
}Резултат
true false true false card ready
Изпълнете кода в конзолата на браузъра. Елементът не се вмъква в страницата. Първите два резултата показват добавянето и премахването на `active`. Следващите два показват, че `ready` присъства, а `active` остава извън списъка. Последният ред съдържа стойността на атрибута `class`.
Свързани уроци
- JavaScript · Урок 7 · Напреднало · Версия: 4
- JavaScript · Урок 32 · Средно · Версия: 3
- JavaScript · Урок 34 · Средно · Версия: 3
- JavaScript · Урок 43 · Средно · Версия: 3