English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
querySelector()Retorna o primeiro elemento correspondente ao seletor ou grupo de seletores especificado no documento.
Se não encontrar correspondências, retorna null.
O método querySelector() retorna apenas o primeiro elemento correspondente ao seletor especificado. Para retornar todos os itens correspondentes, usequerySelectorAll()Método.
document.querySelector(selectors)
document.querySelector('h1');Teste e Veja‹/›Os números na tabela especificam a primeira versão do navegador que suporta completamente o método querySelector():
| Método | |||||
| querySelector() | 1 | 3.5 | 10 | 3.2 | 8 |
| Parâmetro | Descrição |
|---|---|
| selectors | String que contém um ou mais seletores a serem correspondidos. Esta string deve ser válidaSeletor CSSString |
| Retorno: | Representa o documento com o especificadoSeletor CSSO objeto Element do primeiro elemento correspondente ao conjunto, se não houver correspondências, retorna null. |
|---|---|
| Situações excepcionais: | SyntaxError-A sintaxe da string de seletor especificada é inválida |
| Versão DOM: | Nível DOM1 |
Obter o primeiro elemento com id="para":
document.querySelector('#para');Teste e Veja‹/›Obter o primeiro elemento usando class="demo":
document.querySelector(".demo");Teste e Veja‹/›Obter o primeiro elemento <p> do elemento pai <div>:
document.querySelector("div > p");Teste e Veja‹/›Tutorial CSS:Seletor CSS
Referência CSS:CSS#idSeletor
Referência CSS:CSS .classSeletor
DOM Document querySelectorAll()Métodos
DOM Document getElementsByClassName()Métodos
DOM Document getElementsByTagName()Métodos