HTML DOM querySelector()Método
Ejemplo
Obtener el elemento con id="demo" en el documento:
Pruébalo »
Definición y uso
El método querySelector() devuelve un elemento del documento que coincida con el selector CSS especificado.
Nota:El método querySelector() solo devuelve el primer elemento que coincida con el selector especificado. Si necesita devolver todos los elementos, use el método querySelectorAll() en su lugar.
Para más selectores CSS, visite nuestroTutorial de selectores CSSy nuestroManual de referencia de selectores CSS。
Compatibilidad del navegador
Los números de la tabla indican la primera versión del navegador compatible con el método.
| Método | |||||
|---|---|---|---|---|---|
| querySelector() | 4.0 | 8.0 | 3.5 | 3.1 | 10.0 |
Sintaxis
Valores de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| Selector CSS | String | Obligatorio. Especifica uno o más selectores CSS para los elementos coincidentes. Puede utilizar su id, clase, tipo, atributo, valor de atributo, etc. para seleccionar elementos. Para múltiples selectores, sepárelos con comas y devuelve un elemento coincidente. Consejo:Para más selectores CSS, consulte nuestroManual de referencia de selectores CSS。 |
Detalles técnicos
| Versión del DOM: | Selectors Level 1 Document Object |
|---|---|
| Valor de retorno: | El primer elemento que coincida con el selector CSS especificado. Si no se encuentra, devuelve null. Si se especifica un selector no válido, se lanza una excepción SYNTAX_ERR. |
Más ejemplos
Ejemplo
Obtener el primer elemento con class="example" en el documento:
Pruébalo »
Ejemplo
Obtener el primer elemento <p> con class="example" en el documento:
Pruébalo »
Ejemplo
Obtener el primer elemento <a> con el atributo "target" en el documento:
Pruébalo »
Ejemplo
El siguiente ejemplo demuestra cómo usar múltiples selectores.
Supongamos que ha seleccionado dos selectores: los elementos <h2> y <h3>.
El siguiente código agregará un color de fondo al primer elemento <h2> del documento:
<h3>A h3 element</h3>
document.querySelector("h2, h3").style.backgroundColor = "red";
Pruébalo »
Pero, si el elemento <h3> está antes del elemento <h2> en el documento, el elemento <h3> recibirá el color de fondo especificado.
<h2>A h2 element</h2>
document.querySelector("h2, h3").style.backgroundColor = "red";
Pruébalo »
Páginas relacionadas
Manual de referencia de JavaScript:element.querySelector()
Otras extensiones
Objeto Document