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①

瀏覽器相容性

另見