CKTIS / JavaScript
Element.setAttribute — nastavenie atribútu
Element.setAttribute prijíma názov a hodnotu atribútu prvku DOM. Ak je volanie úspešné, metóda atribút pridá alebo nahradí jeho hodnotu.
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
element.setAttribute(qualifiedName, value)Pri úspešnom volaní element.setAttribute(qualifiedName, value) metóda vytvorí chýbajúci atribút alebo aktualizuje prvý atribút s daným názvom. Ide o metódu DOM, nie o funkciu samotného ECMAScriptu.
Ak politika zabezpečenia obsahu (CSP) vynucuje používanie Trusted Types, odovzdanie obyčajného reťazca ako hodnoty chráneného atribútu, napríklad onclick, môže vyvolať výnimku TypeError bez toho, aby sa atribút vytvoril alebo aktualizoval.
Pri prvkoch v mennom priestore HTML, ktoré patria do dokumentu HTML, sa názov prevedie na malé písmená ASCII. Neplatný názov vyvolá DOMException typu InvalidCharacterError. Na nastavenie atribútov s určeným menným priestorom použite setAttributeNS.
Príklady
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Výsledok
ready
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie. Príklad s `data-state` neukazuje, ako vynucovanie Trusted Types ovplyvňuje chránený atribút.