Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje