Element.getAttribute()

Resumo

getAttribute() retorna o valor de um argumento específico do elemento. Se o atributo não existir, o valor retornado será null ou "" (string vazia). Veja Notas para mais detalhes.

Sintaxe

var atributo = element.getAttribute(nomeDoAtributo);

onde

  • atributo √© uma string contendo o valor do nomeDoAtributo.
  • nomeDoAtributo √© o nome do atributo cujo deseja se obter o valor.

Exemplo

var div1 = document.getElementById("div1");
var align = div1.getAttribute("align");

alert(align); // mostra o valor do atributo "align" do elemento com id="div1"

Notas

Quando for utilizado para um elemento HTML num DOM sinalizado como documento HTML,  getAttribute() troca de caixa alta para caixa baixa (mai√ļscula para min√ļscula) seu argumento antes de prosseguir.

Essencialmente todos navegadores (Firefox, Internet Explorer, vers√Ķes recentes do Opera, Safari, Konqueror, e iCab, por exemplo) retornam null quando o atributo especificado n√£o existe no elemento em quest√£o, seguindo que o esbo√ßo atual de especifica√ß√Ķes DOM diz. A velha especifica√ß√£o do DOM 3 Core, por sua vez, diz que correto √© retornar uma string vazia e algumas implementa√ß√Ķes de DOM se comportam dessa forma. Por exemplo, a implementa√ß√£o do getAttribute no XUL (Gecko) segue as especifica√ß√Ķes do DOM 3 Core e retorna uma string vazia. Consequentemente, deve-se usar Element.hasAttribute() para checar a exist√™ncia do atributo antes de utilizar o getAttribute()caso exista a possibilidade do argumento inexistir.

Compatibilidade entre browsers

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte B√°sico 29 23 (Yes) (Yes) 6

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