JavaScript 选择器函数 querySelector 和 querySelectorAll 详解

作者:代码拾荒

时间:2026-10-25

浏览:488

本文详细介绍 JavaScript 中 querySelector 和 querySelectorAll 的用法。querySelector 返回首个匹配元素,querySelectorAll 返回所有匹配元素组成的 NodeList。重点解析 NodeList 的静态快照特性与 getElementsByClassName 返回的 HTMLCollection 实时动态特性的区别,并对比 for、for...of 及 forEach 遍历方式,帮助开发者避免常见陷阱。

文章目录

选择器是 Css 非常强大的功能,早先一般是通过 getElementById 和 getElementsByTagName 来获取页面元素,在一些场景下就很不方便。

后来 DOM 扩展出了 Selector API 标准,其中 Selector API Level 1 包含了 querySelector 和 querySelectorAll 两个方法,可以通过 Css 选择器匹配页面元素。

一、querySelector 查询单个元素

querySelector 用于查询页面中第一个符合规则的元素,可以在 Document 实例和 Element 实例上调用,接收一个选择器字符串参数,如果查找到则返回 HTMLElement 对象,否则返回 null。

语法格式如下:


Document实例.querySelector(选择器字符串);

Element实例.querySelector(选择器字符串);

1. Document 实例调用

Document 实例调用是获取整个页面匹配的元素。

简单示例如下:


// 获取body元素

let body = document.querySelector("body");

console.log(body)

// 获取id为container的元素,只会获取第一个

let container = document.querySelector("#container");

console.log(container)

// 获取class中包含btn的元素,只会获取第一个

let btn = document.querySelector(".btn");

console.log(btn);



// 获取container直接子类class中包含btn的元素,只会获取第一个

let containerBtn = document.querySelector("#container>.btn");

console.log(containerBtn);

2. Element 实例调用

Element 实例调用是获取该元素子树内匹配的元素。

简单示例:


// 获取ID为container的元素

let container = document.querySelector("#container");

// 需要检测元素对象是否存在,存在才有 querySelector 方法

if (container) {

	// 只查找 container 内class包含 btn 的元素。

	let containerBtn = container.querySelector(".btn");

	console.log(containerBtn);

}

理论上来讲,因为 Css 可以通过选择器获取页面任意的元素,所以 Element 实例调用可以直接写成 Document 实例的调用方式,只需要修改选择器字符串参数即可。

例如上例就可以直接写成如下方式:


let containerBtn = document.querySelector("#container .btn");

并且因为少了一个 if 判断,代码就更加简洁。当然在有些业务场景下,ELement 实例是已经确定的了,那么直接用 ELement 实例调用就更加方便了。

二、querySelectorAll 查询所有元素

querySelectorAll 方法和 querySelector 方法类似,只是它是返回所有匹配的元素,类型是 NodeList。

简单示例:


// 假设页面有两个div类名包含 article

// 获取所有类包含 article 的元素

let articleList = document.querySelectorAll(".article");

console.log(articleList);

console.log(articleList.length);

// 控制台输出:

//	NodeList(2) [div.article, div.article]

//	2

querySelectorAll 方法返回的是所有元素,在实务中经常需要遍历,遍历可以使用常规的 for 遍历、for of 遍历和 forEach 遍历。


// for of 遍历

for (let item of articleList) {

	console.log(item);

}

// for 遍历

for (let i = 0; i < articleList.length; i++) {

	console.log(articleList[i]);

	console.log(articleList.item(i));

}

// forEach 遍历

articleList.forEach((item, index) => {

	console.log(item, index);

});

1、for in 遍历的问题

如果使用 for in 遍历,则会把原型链上的一些方法也遍历出来,如 entries,forEach 等。

2、快照而非实时的问题

使用 querySelectorAll 方法获取的 NodeList 是快照,而非实时的数据。

请看下面这个例子:


// 使用 querySelectorAll 获取,articleList 是静态的,非实时的

let articleList = document.querySelectorAll(".article");

console.log(articleList);

console.log(articleList.length); // 2

setTimeout(() => {

	// 增加一个元素

	let div = document.createElement("div");

	div.className = "article";

	document.body.appendChild(div);	

	console.log(articleList);

	// 依旧为2

	console.log(articleList.length);

}, 0);

最后设置了一个定时器,往页面塞了一个 class 为 article 的 div 元素,但是 articleList 的长度依旧是 2。

如果是用 getElementsByClassName 获取,那么 articleList 就是实时的数据。

请看如下例子:


// 使用 getElementsByClassName 获取,articleList是实时的

let articleList = document.getElementsByClassName("article");

console.log(articleList);

console.log(articleList.length);



setTimeout(() => {

	// 增加一个元素

	let div = document.createElement("div");

	div.className = "article";

	document.body.appendChild(div);

	

	console.log(articleList);

	// 这里为3

	console.log(articleList.length);

}, 0);

在控制台查看打印结果:

HTMLCollection 动态效果:

一、querySelector 查询单个元素

使用 getElementsByClassName 获取的对象是 HTMLCollection 类型,会随文档流变化而变化。

三、小结

  • 1. querySelector 和 querySelectorAll 根据 Css 选择器获取页面元素,功能很强大。
  • 2. querySelectorAll 获取的元素是快照,静态的,而非实时的,注意踩坑。

到此这篇关于 JavaScript 选择器函数 querySelector 和 querySelectorAll 的文章就介绍到这了,更多相关 JavaScript 中的 querySelector 和 querySelectorAll 内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章