document.querySelectorAll

Summary

Returns a list of the elements within the document (using depth-first pre-order traversal of the document's nodes) that match the specified group of selectors. The object returned is a  NodeList .

Syntax

elementList
 = document.querySelectorAll(selectors
);

where

• elementList   is a non-live  NodeList   of  element   objects.
• selectors   is a string containing one or more CSS selectors separated by commas.

The returned NodeList will contain all the elements in the document that are matched by any of the specified selectors.

Example

This example returns a list of all  div   elements within the  document   with a class of either "note " or "alert ":

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

Notes

Returns a non-live  NodeList   of all the matching element nodes.

Throws a  SYNTAX_ERR  exception if the specified group of selectors is invalid.

querySelectorAll()   was introduced in the WebApps API.

Browser compatibility

Browser	Support	Notes
Internet Explorer	8
Firefox (Gecko)	3.5   (1.9.1)
Opera	10
Chrome	1
Safari (webkit)	3.2 (525.3)	webk.it/16587

Specification

• Selectors API

See also

• document.querySelector
• element.querySelectorAll
• element.querySelector
• Code snippets for querySelector