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

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

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

在 XHTML（或任何其他 XML 格式）中，原始大小写将被保留，因此如果原始标签名是小写创建的，则会输出 "span"。在 HTML 中，无论创建原始文档时使用什么大小写，都会输出 "SPAN"。

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

此页面最后由 MDN 贡献者于 2024 年 8 月 31 日进行了修改。