轻松上手,快乐学习!

HTML DOM getElementsByClassName() 方法


实例

获取具有指定类名的所有元素:

var x = document.getElementsByClassName("example");
亲自试一试 »

页面下方有更多实例。


定义和用法

getElementsByClassName() 方法以 HTMLCollection 对象的形式返回文档中具有指定类名的所有元素的集合。

HTMLCollection 对象表示节点的集合。这些节点可以通过索引号访问。索引从0开始。

提示: 可以使用 HTMLCollection 对象的 length 属性来确定具有指定类名的元素数,然后可以循环遍历所有元素并提取所需的信息。


浏览器支持

表中的数字指定了完全支持该方法的第一个浏览器版本。

方法
getElementsByClassName() 4.0 9.0 3.0 3.1 9.5

语法

document.getElementsByClassName(classname)

参数值

参数 类型 描述
classname String 必需。要获取的元素的类名。

要搜索多个类名,请用空格分隔,如 "test demo".

技术细节

DOM 版本: Core Level 1 Document Object
返回值: HTMLCollection 对象,表示具有指定类名的元素集合。返回集合中的元素按其在源代码中的显示进行排序。

更多实例

实例

使用 "example" 和 "color" 类获取所有元素:

var x = document.getElementsByClassName("example color");
亲自试一试 »

实例

找出文档中有多少 class="example" 的元素(使用 HTMLCollection 对象的 length 属性):

var x = document.getElementsByClassName("example").length;
亲自试一试 »

实例

使用 class="example" 更改所有元素的背景色:

var x = document.getElementsByClassName("example");
var i;
for (i = 0; i < x.length; i++) {
  x[i].style.backgroundColor = "red";
}
亲自试一试 »

相关页面

CSS 教程: CSS 语法

CSS 参考手册: CSS .class Selector

HTML DOM 参考手册: element.getElementsByClassName()

HTML DOM 参考手册: className 属性

HTML DOM 参考手册: classList 属性

HTML DOM 参考手册: Style 对象

HTML DOM 参考手册: HTMLCollection Object