Element.querySelectorAll()

Sum√°rio

Retorna uma  NodeList de todos os elementos descendentes do elemento que foi invocado que sejam compat√≠veis com o grupo de seletores CSS especificados.

Sintaxe

elementList = baseElement.querySelectorAll(selectors);

Onde

  • elementList √© uma lista n√£o-viva de objetos element.
  • baseElement √© um objeto elemento.
  • selectors √© um grupo de seletores que ser√£o procurados.

Exemplos

Este exemplo retorna uma lista de todos os elementos p no corpo do HTML:

var matches = document.body.querySelectorAll('p');

Este exemplo retorna uma lista de elementos p que estejam contidos em outro elemento, o qual √© uma div que tem a classe 'highlighted':

 

var el = document.querySelector('#test');
var matches = el.querySelectorAll('div.highlighted > p'); 

Este exemplo retorna uma lista de elementos iframe que contenham um atributo data 'src':

var matches = el.querySelectorAll('iframe[data-src]');

Notas

Joga uma excess√£o SYNTAX_ERR se o grupo especificado de seletores for inv√°lido.

querySelectorAll() foi introduzida na WebApps API.

A string passada como argumento para querySelectorAll deve seguir a sintaxe do CSS. veja document.querySelector para um exemplo concreto.

Lembre-se que o valor retornado √© uma NodeList, ent√£o n√£o √© recomendado o uso de recurs√Ķes for...in, nem de nenhum m√©todo de array. Se realmente houver a necessidade de usar m√©todos de uma array, ent√£o o NodeList deve ser convertido em uma array antes de ser usado.

Compatibilidade com Browsers

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Suporte b√°sico 1 3.5 (1.9.1) 8 10 3.2 (525.3)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Suporte b√°sico (Yes) 1.0 (1.9.1) ? ? (Yes)

 

Especifica√ß√Ķes

Veja também