过时
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Node.localName read-only property returns the local part of the qualified name of this node.

In DOM4 this API was moved from 节点 元素 and Attr 接口。

句法

name = element.localName
					
  • 名称 is the local name as a string (see 注意事项 below for details)

范例

(Must be served with XML content type, such as text/xml or application/xhtml+xml )。

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:svg="http://www.w3.org/2000/svg">
<head>
  <script type="application/javascript"><![CDATA[
  function test() {
    var text = document.getElementById('text');
    var circle = document.getElementById('circle');
    text.value = "<svg:circle> has:\n" +
                 "localName = '" + circle.localName + "'\n" +
                 "namespaceURI = '" + circle.namespaceURI + "'";
  }
  ]]></script>
</head>
<body onload="test()">
  <svg:svg version="1.1"
    width="100px" height="100px"
    viewBox="0 0 100 100">
    <svg:circle cx="50" cy="50" r="30" style="fill:#aaa" id="circle"/>
  </svg:svg>
  <textarea id="text" rows="4" cols="55"/>
</body>
</html>
					

注意事项

The local name of a node is that part of the node's qualified name that comes after the colon. Qualified names are typically used in XML as part of the namespace(s) of the particular XML documents. For example, in the qualified name ecomm:partners , partners is the local name and ecomm is the prefix:

<ecomm:business id="soda_shop" type="brick_n_mortar" xmlns:ecomm="http://example.com/ecomm">
  <ecomm:partners>
    <ecomm:partner id="1001">Tony's Syrup Warehouse
    </ecomm:partner>
  </ecomm:partners>
</ecomm:business>
					

注意: Gecko 1.9.2 and earlier, the property returns the upper-cased version of the local name for HTML elements in HTML DOMs (as opposed to XHTML elements in XML DOMs). In later versions, in compliance with HTML5, the property returns in the case of the internal DOM storage, which is lower case for both HTML elements in HTML DOMs and XHTML elements in XML DOMs. The tagName property continues to return in the upper case for HTML elements in HTML DOMs.

For nodes of any type 除了 ELEMENT_NODE and ATTRIBUTE_NODE localName is always null .

规范

规范 状态 注释
DOM (文档对象模型) 3 级核心规范
The definition of 'Node.localName' in that specification.
过时
DOM (文档对象模型) 级别 2 核心规范
The definition of 'Node.localName' 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
localName 弃用 非标 Chrome ? — 46
不支持 ? — 46
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.
Edge 12 — 79
不支持 12 — 79
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.
Firefox 1 — 48
不支持 1 — 48
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.
IE ? Opera ? Safari ? WebView Android ? — 46
不支持 ? — 46
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.
Chrome Android ? — 46
不支持 ? — 46
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.
Firefox Android 45 Opera Android Yes Safari iOS Yes Samsung Internet Android ? — 5.0
不支持 ? — 5.0
This API was moved to the 元素 and Attr APIs according to the DOM4 standard.

图例

完整支持

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

非标。预期跨浏览器支持较差。

非标。预期跨浏览器支持较差。

弃用。不要用于新网站。

弃用。不要用于新网站。

见实现注意事项。

另请参阅

元数据

  • 最后修改:
  1. DOM (文档对象模型)
  2. 节点
  3. 特性
    1. baseURI
    2. baseURIObject
    3. childNodes
    4. firstChild
    5. isConnected
    6. lastChild
    7. localName
    8. namespaceURI
    9. nextSibling
    10. nodeName
    11. nodePrincipal
    12. nodeType
    13. nodeValue
    14. outerText
    15. ownerDocument
    16. parentElement
    17. parentNode
    18. prefix
    19. previousSibling
    20. rootNode
    21. textContent
  4. 方法
    1. appendChild()
    2. cloneNode()
    3. compareDocumentPosition()
    4. contains()
    5. getRootNode()
    6. getUserData()
    7. hasChildNodes()
    8. insertBefore()
    9. isDefaultNamespace()
    10. isEqualNode()
    11. isSameNode()
    12. isSupported()
    13. lookupNamespaceURI()
    14. lookupPrefix()
    15. normalize()
    16. removeChild()
    17. replaceChild()
    18. setUserData()
  5. 继承:
    1. EventTarget
  6. DOM 相关页面
    1. AbortController
    2. AbortSignal
    3. AbstractRange
    4. Attr
    5. ByteString
    6. CDATASection
    7. CSSPrimitiveValue
    8. CSSValue
    9. CSSValueList
    10. CharacterData
    11. ChildNode
    12. 注释
    13. CustomEvent
    14. DOMConfiguration
    15. DOMError
    16. DOMErrorHandler
    17. DOMException
    18. DOMImplementation
    19. DOMImplementationList
    20. DOMImplementationRegistry
    21. DOMImplementationSource
    22. DOMLocator
    23. DOMObject
    24. DOMParser
    25. DOMPoint
    26. DOMPointInit
    27. DOMPointReadOnly
    28. DOMRect
    29. DOMString
    30. DOMTimeStamp
    31. DOMTokenList
    32. DOMUserData
    33. Document
    34. DocumentFragment
    35. DocumentType
    36. 元素
    37. ElementTraversal
    38. Entity
    39. EntityReference
    40. 事件
    41. EventTarget
    42. HTMLCollection
    43. MutationObserver
    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