CKTIS / JavaScript
Element.classList — upravljanje klasama elementa
Element.classList pruža živi DOMTokenList za čitanje i mijenjanje pojedinačnih klasa bez zamjene cijelog atributa class.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
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 vraća isti živi DOMTokenList: promjene atributa class odražavaju se u njemu. Sadrži jedinstvene tokene određenim redoslijedom. Ako nema klasa, popis je prazan.
add(...tokens) dodaje klase bez duplikata, remove(...tokens) uklanja navedene klase, a contains(token) provjerava je li klasa prisutna. Proslijedi zasebne argumente, a ne jedan niz koji sadrži razmake.
toggle(token) mijenja prisutnost; neobavezni force prisiljava dodavanje (true) ili uklanjanje (false). Rezultat pokazuje je li token prisutan na kraju. replace(token, newToken) vraća informaciju o tome je li zamjena izvršena.
Metode koje mijenjaju popis odbacuju prazan token uz SyntaxError, a ASCII-bijele znakove unutar tokena uz InvalidCharacterError — oboje su iznimke DOMException. Ovo je DOM API, a ne značajka ECMAScripta; Node 24 ne dokazuje podršku u preglednicima.
Primjeri
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'));Rezultat
panel false true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.