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). VejaNotas para mais detalhes.

Sintaxe

var atributo = element.getAttribute(nomeDoAtributo);

onde

• atributo é uma string contendo o valor donomeDoAtributo.
• 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

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) retornamnull quando o atributo especificado não existe no elemento em questão, seguindo queo esboço atual de especificações DOM diz. A velha especificação do DOM 3 Core, por sua vez, diz que correto é retornar umastring 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 usarElement.hasAttribute() para checar a existência do atributo antes de utilizar ogetAttribute()caso exista a possibilidade do argumento inexistir.

Compatibilidade com navegadores

Especificação

• DOM Level 2 Core: getAttribute (introduzido emDOM Level 1 Core)
• HTML 5: APIs nos documentos HTML