DOM HTML querySelector()Méthode

Document 对象参考手册Objet Document

Exemple

Obtenir l'élément avec id="demo" dans le document :

document.querySelector("#demo");

Essayez-le vous-même »

Définition et utilisation

La méthode querySelector() renvoie le premier élément du document qui correspond au sélecteur CSS spécifié.

Remarque :La méthode querySelector() renvoie uniquement le premier élément qui correspond au sélecteur spécifié. Si vous avez besoin de renvoyer tous les éléments, utilisez plutôt la méthode querySelectorAll().

Pour plus de sélecteurs CSS, consultez notreTutoriel sur les sélecteurs CSSet notreManuel de référence des sélecteurs CSS。


Prise en charge des navigateurs

Les nombres dans le tableau spécifient la première version de navigateur qui prend entièrement en charge la méthode.

Méthode
querySelector() 4.0 8.0 3.5 3.1 10.0


Syntaxe

document.querySelector(sélecteurs CSS)

Valeurs des paramètres

Paramètre Type Description
sélecteur CSS String Obligatoire. Spécifie un sélecteur CSS pour un ou plusieurs éléments à faire correspondre. Vous pouvez sélectionner des éléments par leur id, class, type, attribut, valeur d'attribut, etc.

Pour plusieurs sélecteurs, séparez-les par des virgules, et renvoie un élément correspondant.

Astuce :Pour plus de sélecteurs CSS, consultez notreManuel de référence des sélecteurs CSS。

Détails techniques

Version DOM : Objet Document des sélecteurs de niveau 1
Valeur de retour : Le premier élément qui correspond au sélecteur CSS spécifié. Si aucune correspondance n'est trouvée, null est renvoyé. Si un sélecteur non valide est spécifié, une exception SYNTAX_ERR est levée.


Plus d’exemples

Exemple

Obtenez le premier élément <p> dans le document :

document.querySelector("p");

Essayez-le vous-même »

Exemple

Obtenez le premier élément avec class="example" dans le document :

document.querySelector(".example");

Essayez-le vous-même »

Exemple

Obtenez le premier élément <p> avec class="example" dans le document :

document.querySelector("p.example");

Essayez-le vous-même »

Exemple

Obtenez le premier élément <a> du document qui possède un attribut "target" :

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

Essayez-le vous-même »

Exemple

L'exemple suivant illustre l'utilisation de plusieurs sélecteurs.

Supposons que vous sélectionniez deux sélecteurs : les éléments <h2> et <h3>.

Le code suivant ajoutera une couleur d'arrière-plan au premier élément <h2> du document :

<h2>Un élément h2</h2>
<h3>Un élément h3</h3>

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

Essayez-le vous-même »

Toutefois, si l'élément <h3> est situé avant l'élément <h2> dans le document, l'élément <h3> recevra la couleur d'arrière-plan spécifiée.

<h3>Un élément h3</h3>
<h2>Un élément h2</h2>

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

Essayez-le vous-même »


Pages associées

Manuel de référence JavaScript :element.querySelector()


Document 对象参考手册Objet Document

Autres extensions