CKTIS / JavaScript
Element.setAttribute — nastavení atributu
Element.setAttribute přijímá název a hodnotu atributu prvku DOM. Pokud se volání podaří, metoda atribut přidá nebo nahradí jeho hodnotu.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.setAttribute(qualifiedName, value)Pokud se volání element.setAttribute(qualifiedName, value) podaří, metoda vytvoří chybějící atribut nebo aktualizuje první atribut s daným názvem. Jde o metodu DOM, nikoli o funkci samotného ECMAScriptu.
Pokud zásady zabezpečení obsahu (CSP) vynucují použití Trusted Types, může předání obyčejného řetězce jako hodnoty chráněného atributu, například onclick, vyvolat výjimku TypeError, aniž by se atribut vytvořil nebo aktualizoval.
U prvků v jmenném prostoru HTML, které patří do dokumentu HTML, se název převede na malá písmena ASCII. Neplatný název vyvolá DOMException typu InvalidCharacterError. K nastavení atributů s určeným jmenným prostorem použijte setAttributeNS.
Příklady
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Výsledek
ready
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze. Příklad s `data-state` neukazuje, jak vynucování Trusted Types ovlivňuje chráněný atribut.