CKTIS / JavaScript
Element.classList — upravljanje razredov elementa
Element.classList omogoča živ DOMTokenList za branje in spreminjanje posameznih razredov, ne da bi zamenjali celoten atribut class.
Različica: 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 vrne isti živi DOMTokenList: spremembe atributa class se odražajo v njem. Vsebuje enolične žetone v določenem vrstnem redu. Če ni razredov, je seznam prazen.
add(...tokens) doda razrede brez dvojnikov, remove(...tokens) odstrani navedene razrede, contains(token) pa preveri, ali je razred prisoten. Podaj ločene argumente, ne enega niza s presledki.
toggle(token) preklopi prisotnost; neobvezni force vsili dodajanje (true) ali odstranjevanje (false). Rezultat pove, ali je žeton prisoten na koncu. replace(token, newToken) vrne podatek o tem, ali je bila zamenjava izvedena.
Metode, ki spreminjajo seznam, zavrnejo prazen žeton z SyntaxError in žeton, ki vsebuje bel znak ASCII (na primer presledek, tabulator ali znak za novo vrstico), z InvalidCharacterError — oboje so izjeme DOMException. To je API DOM, ne funkcija ECMAScript; Node 24 ne dokazuje podpore v brskalnikih.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.