CKTIS / JavaScript
DOMTokenList — управление на токени чрез classList
DOMTokenList представлява набор от токени, например класовете на елемент, достъпни чрез classList. Научете как да добавяте, премахвате, превключвате и проверявате токени, без ръчно да обработвате текста на атрибута class.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);DOMTokenList представлява подреден набор от токени и прави разлика между главни и малки букви. В стойността на атрибута токените се разделят само от знаци за празно пространство от ASCII. Например непрекъсваемият интервал (U+00A0) може да бъде част от един токен на клас, вместо да разделя два класа. Често срещан пример е element.classList: жив обект, който отразява атрибута class. Промените в списъка актуализират атрибута, а промените в атрибута се виждат чрез същия обект. Това не е JavaScript масив.
DOMTokenList.add, извикан като tokens.add("card", "active"), добавя отделни токени и пропуска вече наличните. DOMTokenList.remove, например tokens.remove("active", "missing"), премахва посочените токени; липсващ токен не причинява грешка. И двата метода приемат няколко аргумента и връщат undefined. Подайте класовете поотделно: tokens.add("card", "active"), а не tokens.add("card active"). При add() празен токен причинява DOMException с име SyntaxError, а токен, съдържащ знак за празно пространство от ASCII, причинява InvalidCharacterError.
DOMTokenList.contains, използван като tokens.contains("active"), връща true или false, без да променя списъка. DOMTokenList.toggle, използван като tokens.toggle("selected"), добавя липсващ токен или премахва наличен. Върнатата стойност показва дали токенът е наличен след операцията, а не дали е настъпила промяна. Формата tokens.toggle("ready", force) с булевата стойност true гарантира наличието на токена, а false гарантира отсъствието му. Използвайте тази форма за синхронизиране с изрично състояние, вместо да превключвате на сляпо.
Това е DOM API, а не функция на конкретно издание на ECMAScript. MDN посочва, че интерфейсът и четирите разгледани тук метода са широко достъпни от юли 2015 г.; при по-стари браузъри проверете поддръжката на конкретните варианти на извикване. Наличието на Node 24 в хранилище не доказва поддръжка на DOM. Примерът изисква браузър; не е необходимо елементът да е прикачен към документа.
Примери
{
const element = document.createElement("div");
const tokens = element.classList;
tokens.add("card", "active", "card");
console.log(tokens.contains("active"));
tokens.remove("active", "missing");
console.log(tokens.toggle("selected"));
console.log(tokens.toggle("selected", false));
tokens.toggle("ready", true);
console.log(element.className);
}Резултат
true true false card ready
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.