就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. Attr

在此页

Attr interface represents one of a DOM element's attributes as an object. In most DOM methods, you will directly retrieve the attribute as a string (e.g., Element.getAttribute() ), but certain functions (e.g., Element.getAttributeNode() ) or means of iterating return Attr 类型。 

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Attr" target="_top"><rect x="266" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Attr</text></a></svg></div>
					
  a:hover text { fill: #0095DD; pointer-events: all;}
警告： Starting in Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), a number of deprecated properties and methods output warning messages to the console. You should revise your code accordingly. See Deprecated properties and methods for a complete list.

特性

名称 只读

The attribute's name.

namespaceURI 只读
DOMString representing the namespace URI of the attribute, or null if there is no namespace.
localName 只读
DOMString representing the local part of the qualified name of the attribute.
prefix 只读
DOMString representing the namespace prefix of the attribute, or null if no prefix is specified.
ownerElement 只读

The element holding the attribute.

注意： DOM Level 4 removed this property. The assumption was that since you get an Attr object from an 元素 , you should already know the associated element.
As that doesn't hold true in cases like Attr objects being returned by Document.evaluate , the DOM Living Standard reintroduced the property.

Gecko outputs a deprecation note starting from Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4). This note was removed again in Gecko 49.0 (Firefox 49.0 / Thunderbird 49.0 / SeaMonkey 2.46).

specified 只读
This property always returns true . Originally, it returned true if the attribute was explicitly specified in the source code or by a script, and false if its value came from the default one defined in the document's DTD .
value

The attribute's value.

注意： DOM Level 3 defined namespaceURI , localName and prefix 在 节点 interface. In DOM4 they were moved to Attr .

This change is implemented in Chrome since version 46.0 and Firefox since version 48.0.

Deprecated properties and methods

The following properties have been deprecated. Where available, the appropriate replacement is noted.

属性
This property now always returns NULL .
childNodes 从 Gecko 14 起已过时
This property now always returns an empty NodeList .
firstChild 从 Gecko 14 起已过时
This property now always returns NULL .
isId 只读
Indicates whether the attribute is an "ID attribute". An "ID attribute" being an attribute which value is expected to be unique across a DOM Document. In HTML DOM, "id" is the only ID attribute, but XML documents could define others. Whether or not an attribute is unique is often determined by a DTD or other schema description.
lastChild 从 Gecko 14 起已过时
This property now always returns NULL .
nextSibling
This property now always returns NULL .
nodeName
使用 Attr.name 代替。
nodeType
This property now always returns 2 ( ATTRIBUTE_NODE ).
nodeValue
使用 Attr.value 代替。
ownerDocument

You shouldn't have been using this in the first place, so you probably don't care that this is going away.

parentNode
This property now always returns NULL .
previousSibling
This property now always returns NULL .
schemaTypeInfo 只读
The type information associated with this attribute. While the type information contained in this attribute is guaranteed to be correct after loading the document or invoking Document.normalizeDocument , this property may not be reliable if the node was moved.
specified
This property now always returns true .
textContent
使用 Attr.value 代替。

The following methods have been deprecated:

appendChild() 从 Gecko 14 起已过时
Modify the value of Attr.value 代替。
cloneNode()

You shouldn't have been using this in the first place, so you probably don't care that this is going away.

createAttribute()
使用 Element.setAttribute() 代替。
createAttributeNS()
使用 Element.setAttributeNS() 代替。
getAttributeNode()
使用 Element.getAttribute() 代替。
getAttributeNodeNS()
使用 Element.getAttributeNS() 代替。
hasAttributes() Obsolete since Gecko 21.0

This method now always returns false.

hasChildNodes()

This method now always returns false.

insertBefore()
Modify the value of Attr.value 代替。
isSupported()

You shouldn't have been using this in the first place, so you probably don't care that this is going away.

isEqualNode()

You shouldn't have been using this in the first place, so you probably don't care that this is going away.

normalize()

You shouldn't have been using this in the first place, so you probably don't care that this is going away.

removeAttributeNode()
使用 Element.removeAttribute() 代替。
removeChild() 从 Gecko 14 起已过时
Modify the value of Attr.value 代替。
replaceChild() 从 Gecko 14 起已过时
Modify the value of Attr.value 代替。
setAttributeNode()
使用 Element.setAttribute() 代替。
setAttributeNodeNS()
使用 Element.setAttributeNS() 代替。

规范

规范 状态 注释
DOM
The definition of 'Attr' in that specification. 		实时标准 添加 ownerElement property back
DOM4
The definition of 'Attr' in that specification. 		过时 移动 namespaceURI , prefix and localName from 节点 to this API and removed ownerElement , schemaTypeInfo and isId .
DOM (文档对象模型) 3 级核心规范
The definition of 'Attr' in that specification. 		过时 初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
Attr Chrome 1
1
As of Chrome 45, this property no longer inherits from Node.
Edge 12 Firefox 1 IE 8 Opera 8
8
As of Opera 32, this property no longer inherits from Node.
Safari 1.3 WebView Android 1
1
As of Chrome 45, this property no longer inherits from Node.
Chrome Android 18
18
As of Chrome 45, this property no longer inherits from Node.
Firefox Android 4 Opera Android 10.1
10.1
As of Opera 32, this property no longer inherits from Node.
Safari iOS 1 Samsung Internet Android 1.0
1.0
As of Samsung Internet 5.0, this property no longer inherits from Node.
localName Chrome 46
46
This API was previously available on the 节点 API。
Edge ≤18 Firefox 48
48
This API was previously available on the 节点 API。
IE No Opera 33
33
This API was previously available on the 节点 API。
Safari 1.3 WebView Android 46
46
This API was previously available on the 节点 API。
Chrome Android 46
46
This API was previously available on the 节点 API。
Firefox Android 48
48
This API was previously available on the 节点 API。
Opera Android 33
33
This API was previously available on the 节点 API。
Safari iOS 1 Samsung Internet Android 5.0
5.0
This API was previously available on the 节点 API。
namespaceURI Chrome 46
46
This API was previously available on the 节点 API。
Edge ≤18 Firefox 48
48
This API was previously available on the 节点 API。
IE No Opera 33
33
This API was previously available on the 节点 API。
Safari 1.3 WebView Android 46
46
This API was previously available on the 节点 API。
Chrome Android 46
46
This API was previously available on the 节点 API。
Firefox Android 48
48
This API was previously available on the 节点 API。
Opera Android 33
33
This API was previously available on the 节点 API。
Safari iOS 1 Samsung Internet Android 5.0
5.0
This API was previously available on the 节点 API。
prefix Chrome 46
46
This API was previously available on the 节点 API。
Edge ≤18 Firefox 48
48
This API was previously available on the 节点 API。
IE No Opera 33
33
This API was previously available on the 节点 API。
Safari 1.3 WebView Android 46
46
This API was previously available on the 节点 API。
Chrome Android 46
46
This API was previously available on the 节点 API。
Firefox Android 48
48
This API was previously available on the 节点 API。
Opera Android 33
33
This API was previously available on the 节点 API。
Safari iOS 1 Samsung Internet Android 5.0
5.0
This API was previously available on the 节点 API。

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

元数据

  • 最后修改：
  1. DOM (文档对象模型)
  2. Attr
  3. 特性
    1. localName
    2. namespaceURI
    3. prefix
  4. 继承：
    1. 节点
    2. EventTarget
  5. DOM 相关页面
    1. AbortController
    2. AbortSignal
    3. AbstractRange
    4. ByteString
    5. CDATASection
    6. CSSPrimitiveValue
    7. CSSValue
    8. CSSValueList
    9. CharacterData
    10. ChildNode
    11. 注释
    12. CustomEvent
    13. DOMConfiguration
    14. DOMError
    15. DOMErrorHandler
    16. DOMException
    17. DOMImplementation
    18. DOMImplementationList
    19. DOMImplementationRegistry
    20. DOMImplementationSource
    21. DOMLocator
    22. DOMObject
    23. DOMParser
    24. DOMPoint
    25. DOMPointInit
    26. DOMPointReadOnly
    27. DOMRect
    28. DOMString
    29. DOMTimeStamp
    30. DOMTokenList
    31. DOMUserData
    32. Document
    33. DocumentFragment
    34. DocumentType
    35. 元素
    36. ElementTraversal
    37. Entity
    38. EntityReference
    39. 事件
    40. EventTarget
    41. HTMLCollection
    42. MutationObserver
    43. 节点
    44. NodeFilter
    45. NodeIterator
    46. NodeList
    47. NonDocumentTypeChildNode
    48. ProcessingInstruction
    49. PromiseResolver
    50. 范围
    51. StaticRange
    52. 文本
    53. TextDecoder
    54. TextEncoder
    55. TimeRanges
    56. TreeWalker
    57. TypeInfo
    58. USVString
    59. UserDataHandler
    60. XMLDocument

版权所有  © 2014-2026 乐数软件    

工业和信息化部： 粤ICP备14079481号-1