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

Element.querySelectorAll()

· 52CE 我爱测

返回一个静态(非动态,non-live)的 NodeList,它包含所有元素的非动态节点,该元素来自与其匹配指定的 CSS 选择器组的元素。(基础元素本身不包括,即使它匹配。)

DOM

返回一个静态(非动态,non-live)的 NodeList,它包含所有元素的非动态节点,该元素来自与其匹配指定的 CSS 选择器组的元素。(基础元素本身不包括,即使它匹配。)

[!NOTE] 该 API 的定义已被移动到 ParentNode 接口。

语法

elementList = baseElement.querySelectorAll(selectors);

其中

  • elementList 会是一个 non-live 的 NodeList 对象。
  • baseElement 是一个元素对象。
  • selectors 是一组 CSS 选择器。

示例

dataset selector & attribute selectors

<section class="box" id="sect1">
  <div class="funnel-chart-percent1">10.900%</div>
  <div class="funnel-chart-percent2">3700.00%</div>
  <div class="funnel-chart-percent3">0.00%</div>
</section>
// dataset selectors
const refs = [
  ...document.querySelectorAll(`[data-name*="funnel-chart-percent"]`),
];

// attribute selectors
// const refs = [...document.querySelectorAll(`[class*="funnel-chart-percent"]`)];
// const refs = [...document.querySelectorAll(`[class^="funnel-chart-percent"]`)];
// const refs = [...document.querySelectorAll(`[class$="funnel-chart-percent"]`)];
// const refs = [...document.querySelectorAll(`[class~="funnel-chart-percent"]`)];

下面的例子返回了 HTML 文档中的 body 元素的所有 <p> 后代元素:

var matches = document.body.querySelectorAll("p");

下面的例子返回了 id 为 "test" 的元素的所有 class 属性为 "highlighted" 的所有 div 后代元素的 <p> 子元素:

var el = document.querySelector("#test");
var matches = el.querySelectorAll("div.highlighted > p");

下面的例子返回了 el 元素的后代元素中所有拥有 data-src 属性的 iframe 元素:

var matches = el.querySelectorAll("iframe[data-src]");

附注

如果指定的 CSS 选择器不合法,则会抛出一个SYNTAX_ERR 异常。

返回值是一个 NodeList 对象,所以不推荐使用 for...in 去遍历它 (会遍历出其他无关属性)

想要在它身上使用数组方法,必须先把它转换为真正的数组。

浏览器兼容性

规范

参见

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

资料来源与适用范围

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

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

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