CKTIS / JavaScript
Element.setAttribute — definir um atributo
Element.setAttribute recebe o nome e o valor de um atributo de um elemento do DOM. Se a chamada for bem-sucedida, adiciona o atributo ou substitui o seu valor.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.setAttribute(qualifiedName, value)Se a chamada a element.setAttribute(qualifiedName, value) for bem-sucedida, o método cria o atributo se este não existir ou atualiza o primeiro atributo com esse nome. É um método do DOM, não uma função do próprio ECMAScript.
Quando a política de segurança de conteúdos (CSP) exige a utilização de Trusted Types, passar uma cadeia de caracteres simples como valor de um atributo protegido, como onclick, pode lançar um TypeError sem criar nem atualizar o atributo.
Nos elementos do espaço de nomes HTML que pertencem a um documento HTML, o nome é convertido para minúsculas ASCII. Um nome inválido lança uma DOMException do tipo InvalidCharacterError. Use setAttributeNS para definir atributos com um espaço de nomes especificado.
Exemplos
const element = document.createElement('div');
element.setAttribute('data-state', 'draft');
element.setAttribute('data-state', 'ready');
console.log(element.getAttribute('data-state'));Resultado
ready
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata. O exemplo com `data-state` não mostra o efeito da exigência de utilizar Trusted Types num atributo protegido.