Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.classList — správa tříd prvku

Element.classList poskytuje živý DOMTokenList pro čtení a změnu jednotlivých tříd bez nahrazení celého atributu class.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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 vrací stejný živý DOMTokenList: změny atributu class se v něm projeví. Obsahuje jedinečné tokeny v pořadí. Pokud prvek nemá žádné třídy, je seznam prázdný.

add(...tokens) přidává třídy bez duplicit, remove(...tokens) odstraňuje zadané třídy a contains(token) ověřuje, zda je třída přítomna. Předávejte samostatné argumenty, nikoli jeden řetězec obsahující mezery.

toggle(token) přepíná přítomnost; nepovinný argument force vynutí přidání (true) nebo odebrání (false). Výsledek udává konečnou přítomnost tokenu. replace(token, newToken) vrací informaci o tom, zda k nahrazení došlo.

Metody, které mění seznam, odmítnou prázdný token pomocí SyntaxError a ASCII bílé znaky uvnitř tokenu pomocí InvalidCharacterError — obojí jsou výjimky DOMException. Jde o DOM API, nikoli o funkci ECMAScriptu; Node 24 nedokazuje podporu v prohlížečích.

Příklady

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'));

Výsledek

panel
false
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje