База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници