Element.setAttribute()

Adiciona um novo atributo ou modifica o valor de um atributo existente num elemento espec√≠fico.

Sintaxe

element.setAttribute(name, value);
  • name √© o nome do atributo como string.
  • value √© o novo valor desejado do atributo

Exemplo

No seguinte exemplo, setAttribute() √© usado para definir o atributo disabled em <button>, desabilitado-o.

<button>Hello World</button>
var b = document.querySelector("button");

b.setAttribute("disabled", "disabled");

Notas

Quando chamado em um documento HTML, setAttribute lower-cases its attribute name argument.

Se um atributo especificado j√° existe, ent√£o o valor do atributo √© mudado para o valor passado para a fun√ß√£o. Se n√£o existe, ent√£o o atributo √© criado.

Apesar de getAttribute() retornar null para atributos ausentes, voc√™ precisa usar removeAttribute() ao inv√©s de elt.setAttribute(attr, null) para remover o atributo. Este √ļltimo for√ßar√° o valor null para a string "null", o que n√£o √© provavelmente o que voc√™ quer.

Usar setAttribute() para modificar certos atributos, mais notavelmente valor em XUL, funciona inconsistentemente, como atributos espec√≠ficos de valor padr√£o. Para acessar ou modificar os valores atuais, voc√™ deve usar as propriedades. Por exemplo, use elt.value ao inv√©s de elt.setAttribute('value', val).

Para definir um atributo que n√£o leva valor, assim como o atributo autoplay de um elemento <audio>, use null ou um valor vazio. Por exemplo: elt.setAttribute('autoplay', '')

DOM methods dealing with element's attributes:

Not namespace-aware, most commonly used methods Namespace-aware variants (DOM Level 2) DOM Level 1 methods for dealing with Attr nodes directly (seldom used) DOM Level 2 namespace-aware methods for dealing with Attr nodes directly (seldom used)
setAttribute (DOM 1) setAttributeNS setAttributeNode setAttributeNodeNS
getAttribute (DOM 1) getAttributeNS getAttributeNode getAttributeNodeNS
hasAttribute (DOM 2) hasAttributeNS - -
removeAttribute (DOM 1) removeAttributeNS removeAttributeNode -

Especificação