Element.querySelector()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Retorna o primeiro elemento descendente do elemento em que a função foi invocada e que corresponde aos seletores especificado.
Sintaxe
elemento = elementoBase.querySelector(seletores);
elemento
eelementoBase
são objetoselement
.selectores
é um grupo de selectores.
Exemplo
Neste exemplo é retornado o primeiro elemento style
que, ou não tem nenhum atributo type, ou tem o atributo type igual a text/css
:
var el = document.body.querySelector(
"style[type='text/css'], style:not([type])",
);
Notas
Retorna null
se nenhum elemento for encontrado; caso contrário retorna o primeiro elemento;
Lança uma exceção SYNTAX_ERR
se o grupo de seletores é inválido.
querySelector() foi introduzido em WebApps API.
O argumento de string do querySelector
deve seguir a sintaxe CSS. Veja exemplos concretos em document.querySelector
Especificação
Specification |
---|
DOM Standard # ref-for-dom-parentnode-queryselectorall① |
Compatibilidade com navegadores
BCD tables only load in the browser