Element: tagName 屬性

Baseline 已廣泛支援

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

Element 介面的只讀屬性 tagName 返回呼叫該屬性的元素的標籤名。

例如,如果元素是 <img>,那麼它的 tagName 屬性就是 IMG(對於 HTML 文件;對於 XML/XHTML 文件,大小寫可能不同)。注意:您可以使用 localName 屬性來訪問元素的本地名稱——在上述示例中,就是 img(小寫)。

一個指示元素標籤名的字串。此字串的大小寫取決於文件型別

  • 對於表示 HTML 文件的 DOM 樹,返回的標籤名始終是標準的 uppercase 形式。例如,在 <div> 元素上呼叫的 tagName 返回 "DIV"
  • XML DOM 樹中元素的標籤名會以它們在原始 XML 檔案中書寫時的相同大小寫形式返回。如果 XML 文件包含一個標籤 "<SomeTag>",那麼 tagName 屬性的值將是 "SomeTag"

對於 Element 物件,tagName 的值與其從 Node 繼承的 nodeName 屬性的值相同。

示例

HTML

html
<span id="born">When I was born…</span>

JavaScript

js
const span = document.getElementById("born");
console.log(span.tagName);

在 XHTML(或任何其他 XML 格式)中,原始大小寫將被保留,因此如果原始標籤名是小寫建立的,則會輸出 "span"。在 HTML 中,無論建立原始文件時使用什麼大小寫,都會輸出 "SPAN"

規範

規範
DOM
# ref-for-dom-element-tagname①

瀏覽器相容性

另見