Element: localName 属性

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

Element.localName 只读属性返回元素的限定名称的本地部分。

一个字符串,表示元素限定名称的本地部分。

示例

(必须使用 XML 内容类型提供服务,例如 text/xmlapplication/xhtml+xml)。

xml
<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:svg="http://www.w3.org/2000/svg">
<head>
  <script><![CDATA[
function test() {
  const text = document.getElementById("text");
  const circle = document.getElementById("circle");

  text.value = `<svg:circle> has:
localName = "${circle.localName}"
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" fill="#aaaaaa" id="circle"/>
  </svg:svg>
  <textarea id="text" rows="4" cols="55"/>
</body>
</html>

注意

节点的本地名称是节点限定名称中冒号后面的部分。限定名称通常在 XML 中用作特定 XML 文档命名空间的一部分。例如,在限定名称 comm:partners 中,partners 是本地名称,comm 是前缀。

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

注意: 虽然该属性返回的是内部 DOM 存储的大小写(小写),但请注意,HTML DOM 中的 HTML 元素的 tagName 属性返回的是大写。

规范

规范
DOM
# ref-for-dom-element-localname①

浏览器兼容性

另见