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.