Element.attributes

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

js
// 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.

html
<!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

Specification
DOM Standard
# dom-element-attributes

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também

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