HTML DOM querySelector()Método

Document 对象参考手册Objeto Document

Ejemplo

Obtener el elemento con id="demo" en el documento:

document.querySelector("#demo");

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

document.querySelector(CSS selectors)

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 <p> del documento:

document.querySelector("p");

Pruébalo »

Ejemplo

Obtener el primer elemento con class="example" en el documento:

document.querySelector(".example");

Pruébalo »

Ejemplo

Obtener el primer elemento <p> con class="example" en el documento:

document.querySelector("p.example");

Pruébalo »

Ejemplo

Obtener el primer elemento <a> con el atributo "target" en el documento:

document.querySelector("a[target]");

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:

<h2>A h2 element</h2>
<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.

<h3>A h3 element</h3>
<h2>A h2 element</h2>

document.querySelector("h2, h3").style.backgroundColor = "red";

Pruébalo »


Páginas relacionadas

Manual de referencia de JavaScript:element.querySelector()


Document 对象参考手册Objeto Document

Otras extensiones