Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri