English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
querySelector()Devuelve el primer elemento que coincide con el selector o el grupo de selectores especificados en el documento.
Si no se encuentra una coincidencia, se devuelve null.
El método querySelector() solo devuelve el primer elemento que coincide con el selector especificado. Para devolver todos los elementos coincidentes, utilicequerySelectorAll()Método.
document.querySelector(selectors)
document.querySelector('h1');Ver aquí‹/›Los números en la tabla especifican la primera versión del navegador que admite completamente el método querySelector():
| Método | |||||
| querySelector() | 1 | 3.5 | 10 | 3.2 | 8 |
| Parámetro | Descripción |
|---|---|
| selectors | Una cadena que contiene uno o más selectores que se deben coincidir. Esta cadena debe ser válidaSelector CSSCadena |
| Valor de retorno: | Representa el documento que coincide con elSelector CSSEl objeto Element del primer elemento que coincide con la agrupación, si no hay coincidencias, se devuelve null. |
|---|---|
| Caso excepcional: | SyntaxError-La sintaxis de la cadena de selector especificada no es válida |
| Versión DOM: | Nivel DOM1 |
Obtener el primer elemento con id="para":
document.querySelector('#para');Ver aquí‹/›Obtener el primer elemento utilizando class="demo":
document.querySelector(".demo");Ver aquí‹/›Obtener el primer elemento <p> que es hijo del elemento <div>:
document.querySelector("div > p");Ver aquí‹/›Tutoriales CSS:Selector CSS
CSS Referencia:CSS#idSelector
CSS Referencia:CSS .classSelector
DOM Document querySelectorAll()Métodos
DOM Document getElementsByClassName()Métodos
DOM Document getElementsByTagName()Métodos