CKTIS / JavaScript
Element.setAttribute — nastavljanje atributa
Element.setAttribute sprejme ime in vrednost atributa na elementu DOM. Če je klic uspešen, metoda doda atribut ali zamenja njegovo vrednost.
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
element.setAttribute(qualifiedName, value)Če je klic element.setAttribute(qualifiedName, value) uspešen, metoda ustvari manjkajoči atribut ali posodobi prvi atribut s tem imenom. To je metoda DOM, ne funkcija samega ECMAScripta.
Če pravilnik o varnosti vsebine (CSP) zahteva uporabo Trusted Types, lahko podajanje navadnega niza kot vrednosti zaščitenega atributa, kot je onclick, sproži izjemo TypeError, ne da bi se atribut ustvaril ali posodobil.
Pri elementih v imenskem prostoru HTML, ki pripadajo dokumentu HTML, se ime pretvori v male črke ASCII. Neveljavno ime sproži DOMException vrste InvalidCharacterError. Za nastavljanje atributov z določenim imenskim prostorom uporabite setAttributeNS.
Primeri
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Rezultat
ready
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice. Primer z `data-state` ne prikazuje vpliva obvezne uporabe Trusted Types na zaščiten atribut.