Attr: name 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

Attr 介面的只讀 name 屬性返回屬性的限定名稱,即屬性的名稱,前面帶有名稱空間字首(如果存在)。例如,如果本地名稱是 lang,名稱空間字首是 xml,則返回的限定名稱是 xml:lang

限定名稱始終是小寫形式,無論在建立屬性時的大小寫如何。

一個代表屬性限定名稱的字串。

示例

下面的示例顯示了在點選相應按鈕時,前兩個元素第一個屬性的限定名稱。

HTML

html
<svg xml:lang="en-US" class="struct" height="1" width="1">Click me</svg>
<label xml:lang="en-US" class="struct"></label>

<p>
  <button>Show value for &lt;svg&gt;</button>
  <button>Show value for &lt;label&gt;</button>
</p>

<p>
  Qualified name of the attribute <code>xml:lang</code>:
  <output id="result">None.</output>
</p>

JavaScript

js
const elements = document.querySelectorAll(".struct");
const buttons = document.querySelectorAll("button");
const outputEl = document.querySelector("#result");

let i = 0;
for (const button of buttons) {
  const element = elements[i];
  button.addEventListener("click", () => {
    const attribute = element.attributes[0];
    outputEl.value = attribute.name;
  });
  i++;
}

規範

規範
DOM
# dom-attr-name

瀏覽器相容性

另見

  • Attr.localName 屬性,返回屬性限定名稱的本地部分,以及 Attr.prefix 屬性,即名稱空間字首。
  • Element.tagName() 屬性,返回 Element 的限定名稱。