CKTIS / JavaScript
Element.classList — zarządzanie klasami elementu
Element.classList udostępnia żywy DOMTokenList do odczytu i zmiany pojedynczych klas bez zastępowania całego atrybutu class.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
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 zwraca ten sam, żywy DOMTokenList: zmiany atrybutu class są w nim odzwierciedlane. Przechowuje unikalne tokeny w kolejności. Bez klas lista jest pusta.
add(...tokens) dodaje klasy bez duplikatów, remove(...tokens) usuwa wskazane klasy, a contains(token) sprawdza obecność. Podawaj osobne argumenty, nie jeden ciąg ze spacjami.
toggle(token) przełącza obecność; opcjonalne force wymusza dodanie (true) lub usunięcie (false). Wynik oznacza końcową obecność. replace(token, newToken) zwraca, czy zastąpiono token.
Metody modyfikujące odrzucają pusty token przez SyntaxError, a białe znaki ASCII w tokenie przez InvalidCharacterError — oba to DOMException. To API DOM, nie funkcja ECMAScript; Node 24 nie dowodzi obsługi przeglądarkowej.
Przykłady
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'));Wynik
panel false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.