--- title: Element.attributes slug: Web/API/Element/attributes tags: - API - DOM - Element - Elemento - Property - Propriedade - Reference - Referencia translation_of: Web/API/Element/attributes ---

{{ APIRef("DOM") }}

A propriedade Element.attributes retorna uma coleção de todos os atributos registrados para um nó especificado. É um {{domxref("NamedNodeMap")}}, e não um Array, então não há os métodos de um {{jsxref("Array")}} e os nós indexados {{domxref("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
{{SpecName('DOM WHATWG', '#dom-element-attributes', 'Element.attributes')}} {{Spec2('DOM WHATWG')}} Da {{SpecName('DOM3 Core')}}, movido de {{domxref("Node")}} para {{domxref("Element")}}
{{SpecName('DOM3 Core', 'core.html#ID-84CF096', 'Element.attributes')}} {{Spec2('DOM3 Core')}} Nenhuma alteração a partir da {{SpecName('DOM2 Core')}}
{{SpecName('DOM2 Core', 'core.html#ID-84CF096', 'Element.attributes')}} {{Spec2('DOM2 Core')}} Nenhuma alteração a partir da {{SpecName('DOM1')}}
{{SpecName('DOM1', 'level-one-core.html#ID-84CF096', 'Element.attributes')}} {{Spec2('DOM1')}} Definição inicial.

Compatibilidade com navegadores

{{ CompatibilityTable() }}

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

[1] Antes do Firefox 22, este atributo foi implementado na interface {{domxref("Node")}} (herdada por {{domxref("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