Document.querySelectorAll

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

Especificação

Veja também

Document Tags and Contributors

Contributors to this page: zapimaster
Última atualização por: zapimaster,