ParentNode.querySelector() - Web APIs 编辑

Draft

This page is not complete.

The ParentNode mixin defines the querySelector() method as returning an Element representing the first element matching the specified group of selectors which are descendants of the object on which the method was called.

If you need all the elements matching the selector list, use querySelectorAll() instead.

Note: This method is implemented as Document.querySelector(), DocumentFragment.querySelector() and Element.querySelector().

Syntax

element = parentNode.querySelector(selectors);

Parameters

selectors

A DOMString containing one or more selectors to match against. This string must be a valid compound selector list supported by the browser; if it's not, a SyntaxError exception is thrown. See Locating DOM elements using selectors for more information about using selectors to identify elements. Multiple selectors may be specified by separating them using commas.

Note: Characters which are not part of standard CSS syntax must be escaped using a backslash character. Since JavaScript also uses backspace escaping, special care must be taken when writing string literals using these characters. See Escaping special characters for more information.

Return value

The first Element that matches at least one of the specified selectors or null if no such element is found.

Note: If the specified selectors include a CSS pseudo-element, the returned value is always null.

Exceptions

SyntaxError

The syntax of the specified selectors string is not valid.

Specifications

Browser compatibility

BCD tables only load in the browser

See also

• Locating DOM elements using selectors
• Code snippets for querySelector()
• Attribute selectors in the CSS Guide
• Attribute selectors in the MDN Learning Area
• This method is available as Element.querySelector(), Document.querySelector(), and DocumentFragment.querySelector()