MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Element.getAttribute()

Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

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

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

Etiquetas do documento e colaboradores

 Colaboradores desta página: brunoravanhani, teoli, gabrieltr
 Última atualização por: brunoravanhani,