CKTIS / JavaScript
Element.classList — správa tried prvku
Element.classList poskytuje živý DOMTokenList na čítanie a zmenu jednotlivých tried bez nahradenia celého atribútu class.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
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 vracia ten istý živý DOMTokenList: zmeny atribútu class sa v ňom prejavia. Obsahuje jedinečné tokeny v poradí. Ak prvok nemá žiadne triedy, zoznam je prázdny.
add(...tokens) pridáva triedy bez duplicít, remove(...tokens) odstraňuje zadané triedy a contains(token) kontroluje, či je trieda prítomná. Odovzdávajte samostatné argumenty, nie jeden reťazec obsahujúci medzery.
toggle(token) prepína prítomnosť; nepovinný argument force vynúti pridanie (true) alebo odstránenie (false). Výsledok udáva konečnú prítomnosť tokenu. replace(token, newToken) vracia informáciu o tom, či sa token nahradil.
Metódy, ktoré menia zoznam, odmietnu prázdny token pomocou SyntaxError a ASCII biele znaky v tokene pomocou InvalidCharacterError — obe sú výnimky DOMException. Ide o DOM API, nie o funkciu ECMAScriptu; Node 24 nedokazuje podporu v prehliadačoch.
Prí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ýsledok
panel false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.