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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
---
title: Attr
slug: Web/API/Attr
tags:
- 应用接口
- 文档对象模型
- 浏览器兼容性
translation_of: Web/API/Attr
---
<div>{{APIRef("DOM")}}</div>
<p>该类型使用对象来表示一个DOM元素的属性。在大多数DOM方法中，你可能会直接通过字符串的方式获取属性值（例如{{domxref("Element.getAttribute()")}}），但是一些函数（例如{{domxref("Element.getAttributeNode()")}}）或通过迭代器访问时则返回<code>Attr</code>类型。</p>
<p>{{InheritanceDiagram}}</p>
<div class="warning"><strong>警告：</strong>从Gecko 7.0开始{{geckoRelease("7.0")}}，控制台会输出这些方法和属性将会被移除的警告信息。你应该对代码进行相应的修正。点击<a href="#废弃的属性和方法">废弃的属性和方法</a>查看完整的列表。</div>
<div class="warning">在<a href="https://www.w3.org/standards/history/dom">DOM4[REC]</a>中，为了规范化Attr的实现，它不再继承自{{domxref("Node")}}。在目前<a href="https://www.w3.org/standards/history/dom41">DOM4.1[WD]</a>中又有变动，因此不建议使用Attr对象上有关{{domxref("Node")}}的属性和方法。</div>
<h2 id="属性">属性</h2>
<dl>
<dt>{{domxref("Attr.name", "name")}} {{readOnlyInline}}</dt>
<dd>该属性的名称</dd>
<dt>{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}</dt>
<dd>
<p>表示该属性的命名空间URI{{domxref("DOMString")}}，如果该元素不在命名空间中，则返回null。</p>
</dd>
<dt>{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}</dt>
<dd>
<p>表示该属性的命名空间限定的本地名称{{domxref("DOMString")}}。</p>
</dd>
<dt>{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}</dt>
<dd>表示该属性的命名空间前缀{{domxref("DOMString")}}，如果没有前缀指定则返回null。</dd>
<dt>{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}</dt>
<dd>
<p>该属性所附属的元素节点。</p>
<div class="note">
<p><strong>注意:</strong> DOM Level 4移除了这个方法。由于当你从{{domxref("Element")}}中获得<code>Attr</code>对象时，你应已知相关的元素。<br>
在某些场景下并一定能够得到相关的元素，比如通过{{domxref("Document.evaluate")}}返回的Attr对象，最新的DOM草案再次引入该属性。</p>
<p>Gecko从Gecko 7.0 {{geckoRelease("7.0")}}开始会输出一个废弃的提示信息。 该提示信息在Gecko 49.0 {{geckoRelease("49.0")}}再次被删除。</p>
</div>
</dd>
<dt>{{domxref("Attr.specified", "specified")}} {{readOnlyInline}}</dt>
<dd>该属性将返回<code>真</code>。如果这个属性你在源代码或者在脚本中明确指定的话，它总是返回真。否则它是由文档的<acronym title="Document Type Definition">DTD</acronym>默认定义的，将总是返回<code>假</code>。</dd>
<dt>{{domxref("Attr.value", "value")}}</dt>
<dd>属性的值</dd>
</dl>
<div class="note">
<p><strong>注意:</strong> DOM Level 3定义<code>namespaceURI</code>, <code>localName</code>和<code>prefix</code>为{{domxref("Node")}}接口。在DOM4中被移至<code>Attr</code>。</p>
<p>Chrome 46.0版本以上、Firefox 48.0版本以上实现了该改动。</p>
</div>
<h2 id="废弃的属性和方法">废弃的属性和方法</h2>
<p>这些属性已经被废弃，可以使用合适的属性替代。</p>
<dl>
<dt><code>attributes</code></dt>
<dd>
<p>当前该属性总是返回 <code>NULL</code></p>
</dd>
<dt><code>childNodes</code> {{obsolete_inline(14)}}</dt>
<dd>当前该属性总是返回一个空的 {{domxref("NodeList")}}.</dd>
<dt><code>firstChild</code> {{obsolete_inline(14)}}</dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>NULL</code></dd>
<dt><code>isId</code> {{readOnlyInline}}</dt>
<dd>表明该属性是否一个“ID 属性”。“ID 属性”的值在整个DOM文档中应当是唯一。在HTML DOM文档中属性“id”是一个ID属性，也是唯一一个ID属性；但是在XML文档中可以定义其他ID属性。一个属性是否是唯一的，通常由{{Glossary("DTD")}}或其他文档模式描述文件决定。</dd>
<dt><code>lastChild</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>NULL</code></dd>
<dt><code>nextSibling</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>NULL</code></dd>
<dt><code>nodeName</code></dt>
<dd>使用{{domxref("Attr.name")}}来代替</dd>
<dt><code>nodeType</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font></code>2，表示<code>ATTRIBUTE_NODE</code></dd>
<dt><code>nodeValue</code></dt>
<dd>使用{{domxref("Attr.value")}}来代替</dd>
<dt><code>ownerDocument</code></dt>
<dd>这个属性本不应当在这里被使用，所以应该无须担心其演变</dd>
<dt><code>parentNode</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>NULL</code></dd>
<dt><code>previousSibling</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>NULL</code></dd>
<dt><code>schemaTypeInfo</code> {{obsolete_inline}} {{readOnlyInline}}</dt>
<dd>当前属性的类型信息。然而当加载完文档完或调用{{domxref("Document.normalizeDocument")}}后，这个被认定为绝对正确的包含在节点内的类型信息，会因为节点的移动而变得不可信。</dd>
<dt><code>specified</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该属性总是返回</font>true</code></dd>
<dt><code>textContent</code></dt>
<dd>使用{{domxref("Attr.value")}}来代替</dd>
</dl>
<p>这些方法已经被废弃：</p>
<dl>
<dt><code>appendChild()</code>{{obsolete_inline(14)}}</dt>
<dd>通过编辑{{domxref("Attr.value")}}属性来实现相同的效果</dd>
<dt><code>cloneNode()</code></dt>
<dd>这个方法本不应当在这里被使用，所以无须担心其演变</dd>
<dt><code>createAttribute()</code></dt>
<dd>使用{{domxref("Element.setAttribute()")}}来代替</dd>
<dt><code>createAttributeNS()</code></dt>
<dd>使用{{domxref("Element.setAttributeNS()")}}来代替</dd>
<dt><code>getAttributeNode()</code></dt>
<dd>使用{{domxref("Element.getAttribute()")}}来代替</dd>
<dt><code>getAttributeNodeNS()</code></dt>
<dd>使用{{domxref("Element.getAttributeNS()")}}来代替</dd>
<dt><code>hasAttributes() </code>{{obsolete_inline("21.0")}}</dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该方法总是返回</font></code>false.</dd>
<dt><code>hasChildNodes()</code></dt>
<dd><code><font face="Open Sans, Arial, sans-serif">当前该方法总是返回</font></code>false.</dd>
<dt><code>insertBefore()</code></dt>
<dd>通过编辑{{domxref("Attr.value")}}来实现相同效果</dd>
<dt><code>isSupported()</code></dt>
<dd>这个方法本不应当被在这里使用，所以无须担心其演变</dd>
<dt><code>isEqualNode()</code></dt>
<dd>这个方法本不应当被在这里使用，所以无须担心其演变</dd>
<dt><code>normalize()</code></dt>
<dd>这个方法本不应当被在这里使用，所以无须担心其演变</dd>
<dt><code>removeAttributeNode()</code></dt>
<dd>使用{{domxref("Element.removeAttribute()")}}来代替</dd>
<dt><code>removeChild()</code>{{obsolete_inline(14)}}</dt>
<dd>通过编辑{{domxref("Attr.value")}}来实现相同效果</dd>
<dt><code>replaceChild()</code>{{obsolete_inline(14)}}</dt>
<dd>通过编辑{{domxref("Attr.value")}}来实现相同效果</dd>
<dt><code>setAttributeNode()</code></dt>
<dd>使用{{domxref("Element.setAttribute()")}}来代替</dd>
<dt><code>setAttributeNodeNS()</code></dt>
<dd>使用{{domxref("Element.setAttributeNS()")}}来代替</dd>
</dl>
<h2 id="规格">规格</h2>
<table>
<thead>
<tr>
<th scope="col">规格</th>
<th scope="col">状态</th>
<th scope="col">注释</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName("DOM WHATWG", "#interface-attr", "Attr")}}</td>
<td>{{Spec2("DOM WHATWG")}}</td>
<td>加回 <code>ownerElement</code> 属性</td>
</tr>
<tr>
<td>{{SpecName("DOM4", "#interface-attr", "Attr")}}</td>
<td>{{Spec2("DOM4")}}</td>
<td>将 <code>namespaceURI、prefix</code> 和 <code>localName从</code> {{domxref("Node")}} 移至本API，且删除 <code>ownerElement、</code><code>schemaTypeInfo</code> 和 <code>isId</code>.</td>
</tr>
<tr>
<td>{{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}}</td>
<td>{{Spec2("DOM3 Core")}}</td>
<td>
<p>扩展 schemaTypeInfo， isId</p>
</td>
</tr>
<tr>
<td><a href="https://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#ID-637646024">Document Object Model (DOM) Level 1 Core Specification<br>
Attr</a></td>
<td>Obsolete</td>
<td>初始定义</td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
{{Compat("api.Attr")}}
<h2 id="参考">参考</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>
|
