DOM HTML querySelector()Méthode
Exemple
Obtenir l'élément avec id="demo" dans le document :
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
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 :
Essayez-le vous-même »
Exemple
Obtenez le premier élément avec class="example" dans le document :
Essayez-le vous-même »
Exemple
Obtenez le premier élément <p> avec class="example" dans le document :
Essayez-le vous-même »
Exemple
Obtenez le premier élément <a> du document qui possède un attribut "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 :
<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.
<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()
Autres extensions
Objet Document