大网数据广告活动
Web 标准与前端开发

element.getElementsByTagName

· 52CE 我爱测

`Element.getElementsByTagName()`** 方法返回一个动态的包含所有指定标签名的元素的 HTML 集合HTMLCollection。指定的元素的子树会被搜索,不包括元素自己。返回的列表是动态的,这意味着它会随着 DOM 树的变化自动更新自身。所以,使用相同元素和相同参数时,没有必要多次的调用`Element.getElementsByTagName()` .

DOM

Element.getElementsByTagName() 方法返回一个动态的包含所有指定标签名的元素的 HTML 集合HTMLCollection。指定的元素的子树会被搜索,不包括元素自己。返回的列表是动态的,这意味着它会随着 DOM 树的变化自动更新自身。所以,使用相同元素和相同参数时,没有必要多次的调用Element.getElementsByTagName() .

如果是 HTML 文档中的某个元素调用了getElementsByTagName 函数, 运行前会将参数转为小写字母形式。故不建议在驼峰式命名的 SVG 元素中使用。 Element.getElementsByTagNameNS() 适用于那种情况。

Element.getElementsByTagName 和 Document.getElementsByTagName()类似,除了它的搜索被限制为指定元素的后代。

语法

elements = element.getElementsByTagName(tagName)
  • elements 搜索到的元素的动态 HTML 集合 HTMLCollection,它们的顺序是在子树中出现的顺序。如果没有搜索到元素则这个集合为空。
  • element 搜索从 element 开始。请注意只有 element 的后代元素会被搜索,不包括元素自己。
  • tagName 要查找的限定名。字符 "*" 代表所有元素。考虑到兼容 XHTML,应该使用小写。

实例

// check the alignment on a number of cells in a table.
var table = document.getElementById("forecast-table");
var cells = table.getElementsByTagName("td");
for (var i = 0; i < cells.length; i++) {
  var status = cells[i].getAttribute("data-status");
  if (status == "open") {
    // grab the data
  }
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。