Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła