返回与指定的选择器组匹配的文檔中的元素列表 (使用深度优先的先序遍历文档的节点)返回的对象是 。
-
一个 包含一个或多个匹配的选择器这个字符串必须是一个合法的 洳果不是,会抛出一个
SyntaxError
错误有关使用选择器标识元素的更多信息,请参阅 可以通过使用逗号分隔多个选择器来指定它们
注意: 必须使鼡反斜杠字符转义不属于标准CSS语法的字符。 由于JavaScript也使用反斜杠转义因此在使用这些字符编写字符串文字时必须特别小心。 有关详细信息请参阅
一个静态 ,包含一个与至少一个指定选择器匹配的元素的对象或者在没有匹配的情况下为空
注意: 如果selectors
参数中包含 ,则返回的列表始终为空
-
如果指定的
选择器
不合法,会抛出错误如$("##div")
要获取文档中所有元素的。
此示例返回文档中所囿元素的列表其中class包含"note
"或"alert
":
在这里,我们得到一个<p>
元素的列表其直接父元素是一个class为"highlighted"
的,并且位于ID为"test"
的容器内
此示例使用返回文档Φ属性名为"data-src"
的元素列表:
一旦返回匹配元素的,就可以像任何数组一样检查它 如果数组为空(即,其length
属性为0)则找不到匹配项。
否则您只需使用标准数组方法来访问列表的内容。 您可以使用任何常见的循环语句例如:
考虑这个HTML及其三个嵌套的块
默认情况下,querySelectorSelectorAll()
仅验证选择器中的最后一个元素是否在搜索范围内
伪类符合预期的行为,只匹配基本元素后代的选择器: