轻松上手,快乐学习!

HTML DOM querySelectorAll() 方法


实例

获取文档中 class="example" 的所有元素:

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

页面下方有更多实例。


定义和用法

querySelectorAll() 方法返回文档中匹配指定 CSS 选择器的所有元素,返回 NodeList 对象。

NodeList 对象表示节点的集合。可以通过索引访问,索引值从 0 开始。

提示: 你可以使用 NodeList 对象的 length 属性来获取匹配选择器的元素属性,然后你可以遍历所有元素,从而获取你想要的信息。

更多 CSS 选择器可以参考 CSS 选择器教程 CSS 选择器参考手册


浏览器支持

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

方法
querySelectorAll() 4.0 9.0 3.5 3.2 10.0

注释: Internet Explorer 8 支持 CSS2 选择器。 IE9 及更高版本的浏览器已经支持 CSS3 选择器。


语法

elementList = document.querySelectorAll(CSS selectors)

elementList 是一个静态的 NodeList 类型的对象。

selectors 是一个由逗号连接的包含一个或多个 CSS 选择器的字符串。象。

参数值

参数 类型 描述
CSS selectors String 必需。必须。 指定一个或多个匹配 CSS 选择器的元素。可以通过 id, class, 类型, 属性, 属性值等作为选择器来获取元素。

多个选择器使用逗号(,)分隔。

提示: CSS 选择器更多内容可以参考 CSS 选择器参考手册

技术细节

DOM 版本: Selectors Level 1 Document Object
返回值: 一个 NodeList 对象,表示文档中匹配指定 CSS 选择器的所有元素。 NodeList 是一个静态的 NodeList 类型的对象。如果指定的选择器不合法,则抛出一个 SYNTAX_ERR 异常。

更多实例

实例

获取文档中的所有 <p> 元素,并设置第一个 <p> 元素(索引0)的背景色:

// Get all <p> elements in the document
var x = document.querySelectorAll("p");

// Set the background color of the first <p> element
x[0].style.backgroundColor = "red"; 
亲自试一试 »

实例

使用 class="example" 获取文档中的所有 <p> 元素,并设置第一个 <p> 元素的背景:

// Get all <p> elements in the document with class="example"
var x = document.querySelectorAll("p.example");

// Set the background color of the first <p> element with class="example" (index 0)
x[0].style.backgroundColor = "red"; 
亲自试一试 »

实例

统计文档中有多少 class="example" 的元素(使用 NodeList 对象的 length 属性):

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

实例

使用 class="example" 设置文档中所有元素的背景色:

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

实例

设置文档中所有 <p> 元素的背景色:

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

实例

设置文档中具有 "target" 属性的所有 <a> 元素的边框:

var x = document.querySelectorAll("a[target]");
var i;
for (i = 0; i < x.length; i++) {
  x[i].style.border = "10px solid red";
}
亲自试一试 »

实例

设置父元素为 <div> 元素的每个 <p> 元素的背景色:

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

实例

设置文档中所有 <h2>, <div> 和 <span> 元素的背景色:

var x = document.querySelectorAll("h2, div, span");
var i;
for (i = 0; i < x.length; i++) {
  x[i].style.backgroundColor = "red";
}
亲自试一试 »

相关页面

CSS 教程: CSS 选择器

CSS 参考手册: CSS 选择器参考手册

JavaScript 教程: JavaScript HTML DOM Node List

HTML DOM 参考手册: document.querySelector()

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