ParentNode.querySelector()

草案
本页尚未完工.

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

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

Note: 该方法的实现为 Document.querySelector(), DocumentFragment.querySelector() 和 Element.querySelector().

语法

element = parentNode.querySelector(selectors);

参数

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

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

返回值

第一个 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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
querySelectorChrome Full support 1Edge Full support 12Firefox Full support 3.5IE Full support 9
Notes
Full support 9
Notes
Notes Internet Explorer 8 only supported CSS2 selectors.
Opera Full support 10Safari Full support 4WebView Android Full support ≤37Chrome Android Full support 18Firefox Android Full support YesOpera Android Full support 10.1Safari iOS Full support 3.2Samsung Internet Android Full support Yes

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

See also