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

CKTIS / JavaScript

DOMTokenList.add() — dodajanje žetonov

DOMTokenList.add() dodaja žetone, na primer razrede prek element.classList, preskoči dvojnike in preveri argumente.

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

tokenList.add(...tokens)

DOMTokenList.add() doda žetone v urejeno množico, na primer prek element.classList. Obstoječe žetone ohrani, dvojnike preskoči, nove žetone pa doda po vrstnem redu argumentov. Metodo add() lahko pokličeš brez argumentov. Metoda posodobi povezani atribut, razen če je množica žetonov prazna in atribut ne obstaja. V tem primeru se atribut ne ustvari.

Podaj ločene nize: element.classList.add('card', 'active'). Metoda vrne undefined, ne seznama ali logične vrednosti.

Prazen žeton sproži DOMException z imenom SyntaxError; prisotnost belega znaka ASCII, kot sta tabulator ali znak za novo vrstico, znotraj žetona sproži InvalidCharacterError. Pred dodajanjem se preverijo vsi žetoni: neveljaven argument prepreči dodajanje tudi veljavnih žetonov iz tega klica.

To je API DOM, ne funkcija samega ECMAScripta. Primer zahteva dokument brskalnika; prisotnost Node 24 ne dokazuje podpore za ta API.

Primeri

const element = document.createElement('div');
element.classList.add('card');
const result = element.classList.add('card', 'active');
console.log(element.className);
console.log(result);

try {
  element.classList.add('pending', 'not valid');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Rezultat

card active
undefined
InvalidCharacterError
card active

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri