Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri