HTML DOM Document getElementsByClassName()
示例
获取所有 class="example" 的元素
const collection = document.getElementsByClassName("example");
自己动手试一试 »
获取所有同时具有 "example" 和 "color" 类的元素
const collection = document.getElementsByClassName("example color");
自己动手试一试 »
更多示例见下文。
描述
getElementsByClassName() 方法返回具有指定类名（或多个类名）的元素集合。
getElementsByClassName() 方法返回一个 HTMLCollection。
HTMLCollection
HTMLCollection 是一个类数组的 HTML 元素集合（列表）。
length 属性 返回集合中元素的数量。
元素可以通过索引访问（从 0 开始）。
HTMLCollection 是实时的。当文档更改时它会自动更新。
另请参阅
语法
document.getElementsByClassName(classname)
参数
| 参数 | 描述 |
| 类名 | 必需。 元素的类名。 搜索由空格分隔的多个类名，例如 "test demo"。 |
返回值
| 类型 | 描述 |
| 对象。 | 一个 HTMLCollection 对象。 具有指定类名的元素集合。 元素按其在文档中出现的顺序排序。 |
更多示例
更改所有具有 class="example" 的元素的背景颜色
const collection = document.getElementsByClassName("example");
for (let i = 0; i < collection.length; i++) {
collection[i].style.backgroundColor = "red";
}
自己动手试一试 »
相关页面
CSS 教程：CSS 语法
CSS 参考：CSS .class 选择器
HTML DOM 参考：element.getElementsByClassName()
HTML DOM 参考：className 属性
HTML DOM 参考：classList 属性
HTML DOM 参考：Style 对象
浏览器支持
document.getElementsByClassName() 是 DOM Level 1 (1998) 的一个特性。
所有浏览器都完全支持。
| Chrome | Edge | Firefox | Safari | Opera | IE |
| 是 | 是 | 是 | 是 | 是 | 9-11 |
