From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/zh-cn/web/api/attr/index.html | 238 ++++++++++++++++++++++++++++++++++++ 1 file changed, 238 insertions(+) create mode 100644 files/zh-cn/web/api/attr/index.html (limited to 'files/zh-cn/web/api/attr/index.html') 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 +--- +
{{APIRef("DOM")}}
+ +

该类型使用对象来表示一个DOM元素的属性。在大多数DOM方法中，你可能会直接通过字符串的方式获取属性值（例如{{domxref("Element.getAttribute()")}}），但是一些函数（例如{{domxref("Element.getAttributeNode()")}}）或通过迭代器访问时则返回Attr类型。

+ +

{{InheritanceDiagram}}

+ +
警告：从Gecko 7.0开始{{geckoRelease("7.0")}}，控制台会输出这些方法和属性将会被移除的警告信息。你应该对代码进行相应的修正。点击{{anch("Deprecated properties and methods")}}查看完整的列表。
+ +
在DOM4[REC]中，为了规范化Attr的实现，它不再继承自{{domxref("Node")}}。在目前DOM4.1[WD]中又有变动，因此不建议使用Attr对象上有关{{domxref("Node")}}的属性和方法。
+ +

属性

+ +
+
{{domxref("Attr.name", "name")}} {{readOnlyInline}}
+
该属性的名称
+
{{domxref("Attr.namespaceURI", "namespaceURI")}} {{readOnlyInline}}
+
+

表示该属性的命名空间URI{{domxref("DOMString")}}，如果该元素不在命名空间中，则返回null。

+
+
{{domxref("Attr.localName", "localName")}} {{readOnlyInline}}
+
+

表示该属性的命名空间限定的本地名称{{domxref("DOMString")}}。

+
+
{{domxref("Attr.prefix", "prefix")}} {{readOnlyInline}}
+
表示该属性的命名空间前缀{{domxref("DOMString")}}，如果没有前缀指定则返回null。
+
{{domxref("Attr.ownerElement", "ownerElement")}} {{readOnlyInline}}
+
+

该属性所附属的元素节点。

+ +
+

注意: DOM Level 4移除了这个方法。由于当你从{{domxref("Element")}}中获得Attr对象时，你应已知相关的元素。
+ 在某些场景下并一定能够得到相关的元素，比如通过{{domxref("Document.evaluate")}}返回的Attr对象，最新的DOM草案再次引入该属性。

+ +

Gecko从Gecko 7.0 {{geckoRelease("7.0")}}开始会输出一个废弃的提示信息。 该提示信息在Gecko 49.0 {{geckoRelease("49.0")}}再次被删除。

+
+
+
{{domxref("Attr.specified", "specified")}} {{readOnlyInline}}
+
该属性将返回真。如果这个属性你在源代码或者在脚本中明确指定的话，它总是返回真。否则它是由文档的DTD默认定义的，将总是返回假。
+
{{domxref("Attr.value", "value")}}
+
属性的值
+
+ +
+

注意: DOM Level 3定义namespaceURI, localName和prefix为{{domxref("Node")}}接口。在DOM4中被移至Attr。

+ +

Chrome 46.0版本以上、Firefox 48.0版本以上实现了该改动。

+
+ +

废弃的属性和方法

+ +

这些属性已经被废弃，可以使用合适的属性替代。

+ +
+
attributes
+
+

当前该属性总是返回 NULL

+
+
childNodes {{obsolete_inline(14)}}
+
当前该属性总是返回一个空的 {{domxref("NodeList")}}.
+
firstChild {{obsolete_inline(14)}}
+
当前该属性总是返回NULL
+
isId {{readOnlyInline}}
+
表明该属性是否一个“ID 属性”。“ID 属性”的值在整个DOM文档中应当是唯一。在HTML DOM文档中属性“id”是一个ID属性，也是唯一一个ID属性；但是在XML文档中可以定义其他ID属性。一个属性是否是唯一的，通常由{{Glossary("DTD")}}或其他文档模式描述文件决定。
+
lastChild
+
当前该属性总是返回NULL
+
nextSibling
+
当前该属性总是返回NULL
+
nodeName
+
使用{{domxref("Attr.name")}}来代替
+
nodeType
+
当前该属性总是返回2，表示ATTRIBUTE_NODE
+
nodeValue
+
使用{{domxref("Attr.value")}}来代替
+
ownerDocument
+
这个属性本不应当在这里被使用，所以应该无须担心其演变
+
parentNode
+
当前该属性总是返回NULL
+
previousSibling
+
当前该属性总是返回NULL
+
schemaTypeInfo {{obsolete_inline}} {{readOnlyInline}}
+
当前属性的类型信息。然而当加载完文档完或调用{{domxref("Document.normalizeDocument")}}后，这个被认定为绝对正确的包含在节点内的类型信息，会因为节点的移动而变得不可信。
+
specified
+
当前该属性总是返回true
+
textContent
+
使用{{domxref("Attr.value")}}来代替
+
+ +

这些方法已经被废弃：

+ +
+
appendChild(){{obsolete_inline(14)}}
+
通过编辑{{domxref("Attr.value")}}属性来实现相同的效果
+
cloneNode()
+
这个方法本不应当在这里被使用，所以无须担心其演变
+
createAttribute()
+
使用{{domxref("Element.setAttribute()")}}来代替
+
createAttributeNS()
+
使用{{domxref("Element.setAttributeNS()")}}来代替
+
getAttributeNode()
+
使用{{domxref("Element.getAttribute()")}}来代替
+
getAttributeNodeNS()
+
使用{{domxref("Element.getAttributeNS()")}}来代替
+
hasAttributes() {{obsolete_inline("21.0")}}
+
当前该方法总是返回false.
+
hasChildNodes()
+
当前该方法总是返回false.
+
insertBefore()
+
通过编辑{{domxref("Attr.value")}}来实现相同效果
+
isSupported()
+
这个方法本不应当被在这里使用，所以无须担心其演变
+
isEqualNode()
+
这个方法本不应当被在这里使用，所以无须担心其演变
+
normalize()
+
这个方法本不应当被在这里使用，所以无须担心其演变
+
removeAttributeNode()
+
使用{{domxref("Element.removeAttribute()")}}来代替
+
removeChild(){{obsolete_inline(14)}}
+
通过编辑{{domxref("Attr.value")}}来实现相同效果
+
replaceChild(){{obsolete_inline(14)}}
+
通过编辑{{domxref("Attr.value")}}来实现相同效果
+
setAttributeNode()
+
使用{{domxref("Element.setAttribute()")}}来代替
+
setAttributeNodeNS()
+
使用{{domxref("Element.setAttributeNS()")}}来代替
+
+ +

规格

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
规格状态注释
{{SpecName("DOM WHATWG", "#interface-attr", "Attr")}}{{Spec2("DOM WHATWG")}}加回 ownerElement 属性
{{SpecName("DOM4", "#interface-attr", "Attr")}}{{Spec2("DOM4")}}将 namespaceURI、prefix 和 localName从 {{domxref("Node")}} 移至本API，且删除 ownerElement、schemaTypeInfo 和 isId.
{{SpecName("DOM3 Core", "core.html#ID-637646024", "Attr")}}{{Spec2("DOM3 Core")}} +

扩展 schemaTypeInfo， isId

+
Document Object Model (DOM) Level 1 Core Specification
+ Attr		Obsolete初始定义
+ +

浏览器兼容性

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureChromeEdgeFirefox (Gecko)Internet ExplorerOperaSafari
基本支持{{CompatVersionUnknown}}[1]{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidAndroid WebviewEdgeFirefox Mobile (Gecko)IE MobileOpera MobileSafari MobileChrome for Android
基本支持{{CompatVersionUnknown}}{{CompatVersionUnknown}}[1]{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}[1]
+
+ +

[1] As of Chrome 45, this property no longer inherits from Node.

+ +

参考

+ + -- cgit v1.2.3-54-g00ecf