ParentNode.querySelector()

草案
本页尚未完工.

ParentNode mixin 将 querySelector() 方法定义为返回一个 Element 表示与指定的选择器组匹配的第一个元素,这些选择器是调用该方法的对象的后代。

如果您需要与选择器列表匹配的所有元素,使用 querySelectorAll()

Syntax

element = parentNode.querySelector(selectors);

Parameters

selectors
DOMString 包含一个或多个要匹配的选择器。该字符串必须是浏览器支持的compound selector list ;如果不是, 会抛出 SyntaxError 异常. 查阅 Locating DOM elements using selectors 获取有关选择器使用的更多信息. 可以通过使用逗号分隔多个选择器来指定它们。

Note: 必须使用反斜杠字符转义不属于CSS语法的字符。由于JavaScript也使用退格转义,因此在使用这些字符编写字符串文字是必须特别小心。查阅 Escaping special characters 获取更多信息。

Return value

第一个 Element 匹配至少一个指定的选择器,如果没有找到这样的元素,返回 null 。

Note: 如果指定的选择器包含 CSS pseudo-element, 则返回值始终为 null.

Exceptions

SyntaxError
指定的 selectors 字符串语法无效。

Specifications

Specification Status Comment
DOM
ParentNode.querySelector()
Living Standard Living standard
Selectors API Level 2
ParentNode.querySelector()
Obsolete No change
DOM4
ParentNode.querySelector()
Obsolete Initial definition
Selectors API Level 1
document.querySelector()
Obsolete Original definition

Browser compatibility

No compatibility data found. Please contribute data for "api.ParentNode.querySelector" (depth: 1) to the MDN compatibility data repository.

See also

文档标签和贡献者

此页面的贡献者: guoyi
最后编辑者: guoyi,