Introdução
Retorna uma lista de elementos presentes no documento (usando ordenação em profundidade, pré-ordenada e transversal dos nós do documento) que coincidam com grupo de seletores especificado. O objeto retornado é uma NodeList.
Sintaxe
listaElementos = document.querySelectorAll(seletores);
onde
- listaElementos é uma NodeList não-viva de objetos element.
seletoresé uma string contendo um ou mais seletores CSS separados por vírgulas.
A NodeList retornada irá conter todos os elementos do documento que coincidam com os seletores especificados. Se a string seletores conter um pseudo-elemento CSS, a
listaElementos
retornada estará vazia.
Exemplo
Esse exemplo retorna uma lista de todos os elementos div presentes no document com o atributo classe de valor "nota" ou "alerta":
var matches = document.querySelectorAll("div.nota, div.alerta");
Notas
Retorna uma NodeList não-viva de todos os elementos que coincidam com os seletores informados.
Joga uma SYNTAX_ERR exception se o grupo especificado de seletores for inválido.
querySelectorAll() foi introduzida na WebApps API.
Navegadores baseados em WebKit têm um bug: quando a string seletores contém um pseudo-elemento CSS, a
listaElementos
retornada não esta vazia, neste caso ela contém o elemento <html>.
Compatibilidade entre navegadores
| Possui | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Suporte básico | 1 | 3.5 (1.9.1) | 8 | 10 | 3.2 (525.3) |
| Possui | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Suporte básico | 2.1 | sim | 9 | 10.0 | 3.2 |