Resumen

Devuelve una lista de los elementos dentro del documento (con profundidad-primer-pre-orden transversal de los nodos del documento) que coinciden con el grupo especificado de selectores. El objeto devuelto es un NodeList.

Nota: La definición de esta API fue movida a la interfaz  ParentNode

Sintaxis

elementList = document.querySelectorAll(selectors);

donde

El NodeList devuelto contendrá todos los elementos en el documento que coinciden con cualquiera de los selectores especificados. Si la cadena selectores contiene un pseudo elemento CSS, el elementList devuelto estará vacío.

Ejemplo

Este  ejemplo devuelve una lista de todos los elementos div dentro del document que contengan la clase  "note" o "alert"

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

Otro  ejemplo usándolo una función:

function getElements(elmSel) {
    return document.querySelectorAll(elmSel);
}  

getElements(".note");

Notas

Devuelve un NodeList no-vivo de todos los  elementos nodos coincidentes.

Arroja la excepción SYNTAX_ERR si el grupo de selectores especificado es inválido.

querySelectorAll() fue introducido en la API WebApps.

Los navegadores WebKit poseen un bug: cuando la cadena selectors contiene un pseudo-elemento CSS,  el elementList retornado no esta vacío pero contiene el elemento <html>.

El argumento string pasado a querySelectorAll debe seguir la sintaxis CSS. Ver document.querySelector  para ejemplos concretos.

Especificaciones

Specification Status Comment
Selectors API Level 1
La definición de 'document.querySelector()' en esta especificación.
Obsolete Initial definition
 

Compatibilidad con navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Soporte básico 1 3.5 (1.9.1) 9
8 (CSS2 selectors only)
10 3.2 (525.3)
Característica Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico 2.1 si 9 10.0 3.2

[1] Internet Explorer 8 only supported CSS2 selectors.

Ver también

Etiquetas y colaboradores del documento

Etiquetas: 
 Colaboradores en esta página: padrecedano, lfottaviano, joeljose
 Última actualización por: padrecedano,