元素:tagName 属性

tagNameElement 接口的只读属性,它返回调用它的元素的标签名称。

例如,如果元素是 <img>,它的 tagName 属性是 IMG(对于 HTML 文档;对于 XML/XHTML 文档,它的大小写可能不同)。注意:您可以使用 localName 属性访问元素的本地名称 - 在示例中,它是 img(小写)。

一个表示元素标签名称的字符串。此字符串的大小写取决于文档类型

  • 对于表示 HTML 文档的 DOM 树,返回的标签名称始终采用规范的大写形式。例如,在 <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①

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅