1 files changed, 238 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/attr/index.html b/files/zh-cn/web/api/attr/index.html
new file mode 100644
index 0000000000..a87717916d
--- /dev/null
+++ b/files/zh-cn/web/api/attr/index.html
@@ -0,0 +1,238 @@
+---
+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")}}，控制台会输出这些方法和属性将会被移除的警告信息。你应该对代码进行相应的修正。点击{{anch("Deprecated properties and methods")}}查看完整的列表。</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>
+
+<p>{{CompatibilityTable}}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Chrome</th>
+   <th>Edge</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari</th>
+  </tr>
+  <tr>
+   <td>基本支持</td>
+   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Android</th>
+   <th>Android Webview</th>
+   <th>Edge</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>IE Mobile</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+   <th>Chrome for Android</th>
+  </tr>
+  <tr>
+   <td>基本支持</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<p>[1] As of Chrome 45, this property no longer inherits from Node.</p>
+
+<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>