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.