Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes