CKTIS / JavaScript
DOMTokenList.add() — pridávanie tokenov
DOMTokenList.add() pridáva tokeny, napríklad triedy cez element.classList, vynecháva duplicity a overuje argumenty.
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
tokenList.add(...tokens)DOMTokenList.add() pridáva tokeny do usporiadanej množiny, napríklad prostredníctvom element.classList. Zachováva existujúce tokeny, vynecháva duplicity a nové tokeny pridáva v poradí argumentov. Metódu add() možno volať aj bez argumentov. Metóda aktualizuje súvisiaci atribút okrem prípadu, keď je množina tokenov prázdna a atribút chýba. V takom prípade sa atribút nevytvorí.
Odovzdávajte samostatné reťazce: element.classList.add('card', 'active'). Metóda vracia undefined, nie zoznam ani logickú hodnotu.
Prázdny token vyvolá DOMException s názvom SyntaxError; ASCII biele znaky vo vnútri tokenu vyvolajú InvalidCharacterError. Všetky tokeny sa overujú pred vložením: neplatný argument zabráni pridaniu aj platných tokenov z tohto volania.
Ide o API DOM, nie o funkciu samotného ECMAScriptu. Príklad vyžaduje dokument prehliadača; prítomnosť Node 24 nedokazuje podporu tohto API.
Príklady
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);Výsledok
card active undefined InvalidCharacterError card active
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.