Element.attributes

Esta tradução está incompleta. Ajude atraduzir este artigo.

A propriedade Element.attributes retorna uma coleção de todos os atributos registrados para um nó especificado. É um NamedNodeMap, e não um Array, então não há os métodos de um Array e os nós indexados Attr podem ser diferentes entre os navegadores. Para ser mais específico, attributes é um par de chave/valor de strings que representa qualquer informação relacionada ao atributo.

Sintaxe

var attr = element.attributes;

Exemplo

Exemplos básicos

// Obtem o primeiro elemento <p> no documento
var para = document.getElementsByTagName("p")[0];
var atts = para.attributes;

Listando os atributos dos elementos

Indexadores numéricos são úteis para percorrer através de todos os atributos de um elemento.
O exemplo a seguir percorre através dos nós dos atributos do elemento no documento que tenha o id de "p1", e imprime o valor de cada atributo.

<!DOCTYPE html>

<html>

 <head>
  <title>Exemplo com atributos</title>
  <script type="text/javascript">
   function listAttributes() {
     var paragraph = document.getElementById("paragraph");
     var result = document.getElementById("result");

     // Antes, vamos verificar se o paragrafo tem algum atributo
     if (paragraph.hasAttributes()) {
       var attrs = paragraph.attributes;
       var output = "";
       for(var i = attrs.length - 1; i >= 0; i--) {
         output += attrs[i].name + "->" + attrs[i].value;
       }
       result.value = output;
     } else {
       result.value = "Nenhum atributo para mostrar";
     }
   }
  </script>
 </head>

<body>
 <p id="paragraph" style="color: green;">Paragrafo de exemplo</p>
 <form action="">
  <p>
    <input type="button" value="Mostra o nome e o valor do atributo"
      onclick="listAttributes();">
    <input id="result" type="text" value="">
  </p>
 </form>
</body>
</html>

Especificações

Especificação Status Comentário
DOM
The definition of 'Element.attributes' in that specification.
Living Standard Da Document Object Model (DOM) Level 3 Core Specification, movido de Node para Element
Document Object Model (DOM) Level 3 Core Specification
The definition of 'Element.attributes' in that specification.
Recommendation Nenhuma alteração a partir da Document Object Model (DOM) Level 2 Core Specification
Document Object Model (DOM) Level 2 Core Specification
The definition of 'Element.attributes' in that specification.
Recommendation Nenhuma alteração a partir da Document Object Model (DOM) Level 1 Specification
Document Object Model (DOM) Level 1 Specification
The definition of 'Element.attributes' in that specification.
Recommendation Definição inicial.

Compatibilidade entre os navegadores

Funcionalidade Chrome Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) (Yes) [1] 6.0 [2] (Yes) (Yes)
Funcionalidade Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) [1] (Yes) (Yes) (Yes)

[1] Antes do Firefox 22, este atributo foi implementado na interface Node (herdada por Element). foi movido para esta interface para obedecer a especificação e o uso em outros navegadores.

[2] Internet Explorer 5.5 retorna um map contendo os valores ao invés dos objetos do atributo.

Veja também

  • NamedNodeMap, a interface do objeto retornado
  • Considerações sobre a compatibilidade entre os navegadores: em quirksmode

Etiquetas do documento e colaboradores

 Colaboradores desta página: DiasNetoJ
 Última atualização por: DiasNetoJ,