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

Element.getElementsByClassName()

· 52CE 我爱测

**`Element.getElementsByClassName()`** 方法返回一个即时更新的(live)HTMLCollection,包含了所有拥有指定 class 的子元素。当在 document 对象上调用此方法时,会检索整个文档,包括根元素。

Element.getElementsByClassName() 方法返回一个即时更新的(live)HTMLCollection,包含了所有拥有指定 class 的子元素。当在 document 对象上调用此方法时,会检索整个文档,包括根元素。

相似地,Document.getElementsByClassName 方法会在整个文档上执行;它返回指定拥有指定 class 名称的 document 根节点的后代元素。

语法

var elements = element.getElementsByClassName(names);
  • elements 是一个即时更新的(live)HTMLCollection。
  • names 是一个字符串,表示要匹配的类名(class names)列表;类名被空白符分隔。
  • element 是文档中的任一 Element。

例子

获取所有包含 class 名称为 test 的元素:

element.getElementsByClassName("test");

获取所有包含 red 和 test class 名的元素:

element.getElementsByClassName("red test");

获取 id 为 main 的元素的所有包含一个 test class 名的后代元素:

document.getElementById("main").getElementsByClassName("test");

可以在任何 HTMLCollection 上面使用 Array 的方法,要把 HTMLCollection 作为该方法的上下文对象(this)。下例,查找类名为 test 的元素中的所有 div 元素:

var testElements = document.getElementsByClassName("test");
var testDivs = Array.prototype.filter.call(
  testElements,
  (testElement) => testElement.nodeName === "DIV",
);

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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