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