CKTIS / JavaScript
Element.classList — управление на класовете на елемент
Element.classList предоставя жив DOMTokenList за четене и промяна на отделни класове, без да се заменя целият атрибут class.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
element.classList
element.classList.add(...tokens)
element.classList.remove(...tokens)
element.classList.contains(token)
element.classList.toggle(token, force)
element.classList.replace(token, newToken)Element.classList връща същия жив DOMTokenList: промените в атрибута class се отразяват в него. Съдържа уникални токени в определен ред. Ако няма класове, списъкът е празен.
add(...tokens) добавя класове без дубликати, remove(...tokens) премахва посочените класове, а contains(token) проверява дали даден клас присъства. Подават се отделни аргументи, а не един низ с интервали.
toggle(token) превключва присъствието; незадължителният force налага добавяне (true) или премахване (false). Резултатът показва дали токенът присъства накрая. replace(token, newToken) връща дали е извършена замяна.
Методите, които променят списъка, отхвърлят празен токен с SyntaxError, а токен, съдържащ бял знак от ASCII (например интервал, табулация или знак за нов ред), с InvalidCharacterError — и двете са изключения DOMException. Това е DOM API, а не функция на ECMAScript; Node 24 не доказва поддръжка в браузърите.
Примери
const element = document.createElement('div');
const classes = element.classList;
classes.add('card', 'selected');
classes.add('card');
classes.toggle('selected', false);
classes.replace('card', 'panel');
console.log(element.className);
console.log(classes.contains('selected'));
element.className = 'ready';
console.log(classes.contains('ready'));Резултат
panel false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.