Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.setAttribute — ustawianie atrybutu

Element.setAttribute przyjmuje nazwę i wartość atrybutu elementu DOM. Jeśli wywołanie się powiedzie, metoda dodaje atrybut lub zastępuje jego wartość.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

element.setAttribute(qualifiedName, value)

Jeśli wywołanie element.setAttribute(qualifiedName, value) się powiedzie, metoda tworzy brakujący atrybut albo aktualizuje pierwszy atrybut o podanej nazwie. To metoda DOM, nie funkcja samego ECMAScript.

Gdy polityka CSP wymusza stosowanie Trusted Types, przekazanie zwykłego ciągu znaków jako wartości chronionego atrybutu, takiego jak onclick, może spowodować zgłoszenie wyjątku TypeError bez utworzenia ani aktualizacji atrybutu.

Dla elementów w przestrzeni nazw HTML należących do dokumentu HTML nazwa jest zamieniana na małe litery ASCII. Nieprawidłowa nazwa powoduje DOMException typu InvalidCharacterError. Do ustawiania atrybutów z określoną przestrzenią nazw służy setAttributeNS.

Przykłady

const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));

Wynik

ready

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji. Przykład z `data-state` nie pokazuje, jak wymuszanie Trusted Types wpływa na chroniony atrybut.

Źródła