Sumário
Retorna o primeiro elemento dentro do documento (usando ordenação em profundidade, pré-ordenada e transversal dos nós do documento) que corresponde ao grupo especificado de seletores.
Sintaxe
element = document.querySelector(selectors);
Onde:
element
é um objetoElement
.selectors
é uma string que contém um ou mais seletores CSS separados por vírgulas.
Exemplo
Neste exemplo, o primeiro elemento no documento com a classe "myclass
" é retornado:
var el = document.querySelector(".myclass");
Notas
Retorna null
se nenhum resultado for encontrado; caso contrário, retorna o primeiro elemento correspondente.
Se o seletor utilizado for um ID
e este ID
foi erroneamente utilizado várias vezes no documento, ele retorna somente o primeiro elemento correspondente.
Gera uma exceção SYNTAX_ERR
se o grupo de seletores utilizado for inválido.
querySelector()
foi introduzido com a API de seletores.
Compatibilidade dos navegadores
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) |
---|---|---|---|---|---|
Basic support | 1 | 3.5 (1.9.1) bug 416317 |
8 | 10 | 3.2 (525.3) WebKit bug 16587 |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | 2.1 | yes | 9 | 10.0 | 3.2 |