ParentNode.querySelectorAll()

返回一个 NodeList 表示元素的列表,把当前的元素作为根与指定的选择器组相匹配。

语法

elementList = document.querySelectorAll(selectors);

where

  • elementList 是由元素对象 element 组成的非动态节点列表 non-live NodeList
  • selectors 是一个或多个CSS选择器,这些选择器由逗号隔开。

返回的 NodeList 将包含文档中的所有节点,这些都是由特定选择器匹配的。如果选择器字符串包含了一个CSS伪元素,将返回空的 elementList。

例子

这个例子返回了所有 class 为 "note" 或者 "alert" 的 div 元素的一个列表:

var matches = document.querySelectorAll("div.note, div.alert");

备注

返回所有匹配到的节点的一个非活动节点列表。

抛出一个 SYNTAX_ERR 错误,如果特定的选择器组是无效的。

querySelectorAll() 在WebApps API 中介绍了。

传递给querySelectorAll() 的字符串必须遵循 CSS 语法。在document.querySelector查看具体的例子。

技术参数

Specification Status Comment
Selectors API Level 2
ParentNode.querySelectorAll()
Obsolete No change
DOM4
ParentNode.querySelectorAll()
Obsolete Initial definition

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1 (Yes) 3.5 9
8[1]
10 3.2
Feature Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 2.1 (Yes) (Yes) 9 10.0 3.2

[1] Internet Explorer 8 只支持 CSS2 选择器。

扩展阅读

文档标签和贡献者

 此页面的贡献者: hawtim, _sollrei, ZZES_REN
 最后编辑者: hawtim,