1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
---
title: Attr
slug: Web/API/Attr
tags:
- API
- DOM
- Gecko DOM
- JavaScript
translation_of: Web/API/Attr
---
<p>{{APIRef("DOM")}}<br>
Este tipo representa um atributo de elemento DOM como um objeto. Na maioria dos métodos DOM, você provavelmente irá retornar diretamente o atributo como uma string (e.g., {{domxref("Element.getAttribute()")}}, mas certas funções (e.g., {{domxref("Element.getAttributeNode()")}}) ou meios de iteração retornam tipos <code>Attr</code>.</p>
<p>{{InheritanceDiagram}}</p>
<div class="warning"><strong>Aviso:</strong> Começando no Gecko 7.0 {{geckoRelease("7.0")}}, os que serão removidos mostram mensagens de aviso no console. Você deve revisar seu código de acordo. Veja <a href="https://developer.mozilla.org/pt-BR/docs/Web/API/Attr$edit#Deprecated_properties_and_methods">métodos e propriedades descontinuadas</a> para uma lista completa.</div>
<h2 id="Propriedades">Propriedades</h2>
<p> </p>
<dl>
<dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt>
<dd>O nome do Atributo.</dd>
</dl>
<p> </p>
<p> </p>
<dl>
<dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando o namespace URI do atributo, ou <code>null</code> se não há namespace</dd>
<dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando a parte local do nome qualificado do atributo.</dd>
<dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt>
<dd>Uma {{domxref("DOMString")}} representando o prefixo do namespace do atributo ou <code>null</code> se nenhum prefixo foi especificado.</dd>
<dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt>
<dd>
<p>O elemento que possui o atributo.</p>
</dd>
</dl>
<p> </p>
<div class="note">
<p><strong>Nota:</strong> DOM Level 4 removeu esta propriedade. Foi suposto que como você recebe um objeto <code>Attr</code> de um {{domxref("Element")}}, você já deve saber qual é o elemento associado.<br>
Como isto não é sempre verdadeiro em casos como objetos <code>Attr</code> sendo retornados pelo {{domxref("Document.evaluate")}}, o DOM Living Standard reintroduziu a propriedade.</p>
<p>Gecko mostra uma mensagem de descontinuação começando no Gecko 7.0 {{geckoRelease("7.0")}}. Esta mensagem foi removida novamente no Gecko 49.0 {{geckoRelease("49.0")}}.</p>
</div>
<h2 id="Propriedades_e_métodos_descontinuados">Propriedades e métodos descontinuados</h2>
<p>As seguintes propriedades e métodos foram descontinuados. Quando disponíveis, são substituidas adequadamente.</p>
<dl>
<dt><code>attributes</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>childNodes</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>firstChild</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>lastChild</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>nextSibling</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>nodeName</code></dt>
<dd>Use {{domxref("Attr.name")}} no lugar.</dd>
<dt><code>nodeType</code></dt>
<dd>Esta propriedade agora sempre retorna 2 (<code>ATTRIBUTE_NODE</code>).</dd>
<dt><code>nodeValue</code></dt>
<dd>Use {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>ownerDocument</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>ownerElement</code></dt>
<dd>Desde que você obtenha o objeto <code>Attr</code> de um {{domxref("Element")}}, você já conhece os elementos associados.</dd>
<dt><code>parentNode</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>previousSibling</code></dt>
<dd>Esta propriedade agora sempre retorna <code>NULL</code>.</dd>
<dt><code>specified</code></dt>
<dd>Esta propriedade agora sempre retorna <code>true</code>.</dd>
<dt><code>textContent</code></dt>
<dd>Use {{domxref("Attr.value")}} no lugar.</dd>
</dl>
<p>Os seguintes métodos foram reprovados:</p>
<dl>
<dt><code>appendChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>cloneNode()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>createAttribute()</code></dt>
<dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
<dt><code>createAttributeNS()</code></dt>
<dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
<dt><code>getAttributeNode()</code></dt>
<dd>Use {{domxref("Element.getAttribute()")}} no lugar.</dd>
<dt><code>getAttributeNodeNS()</code></dt>
<dd>Use {{domxref("Element.getAttributeNS()")}} no lugar.</dd>
<dt><code>hasAttributes() </code>{{obsolete_inline("21.0")}}</dt>
<dd>Este método agora sempre retorna false.</dd>
<dt><code>hasChildNodes()</code></dt>
<dd>Este método agora sempre retorna false.</dd>
<dt><code>insertBefore()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>isSupported()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>isEqualNode()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>normalize()</code></dt>
<dd>Provavelmente você nunca utilizou isto, então você não se importa que isso vai desaparecer.</dd>
<dt><code>removeAttributeNode()</code></dt>
<dd>Use {{domxref("Element.removeAttribute()")}} no lugar.</dd>
<dt><code>removeChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>replaceChild()</code></dt>
<dd>Modifique o valor de {{domxref("Attr.value")}} no lugar.</dd>
<dt><code>setAttributeNode()</code></dt>
<dd>Use {{domxref("Element.setAttribute()")}} no lugar.</dd>
<dt><code>setAttributeNodeNS()</code></dt>
<dd>Use {{domxref("Element.setAttributeNS()")}} no lugar.</dd>
</dl>
<h2 id="Especificações">Especificações</h2>
<ul>
<li><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024" title="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-637646024">Document Object Model Core level 3: Interface Attr</a></li>
<li><a class="external" href="http://www.w3.org/TR/dom/#interface-attr">Document Object Model 4: Interface Attr</a></li>
</ul>
|