DOM HTML querySelector()Méthode
Exemples
Modifiez le contenu textuel du premier élément enfant de l'élément <div> avec class="demo" :
Essayez-le vous-même »
Définition et utilisation
La méthode querySelector() renvoie le premier élément enfant qui correspond au sélecteur CSS spécifié d'un élément.
Remarque :La méthode querySelector() ne renvoie que le premier élément qui correspond au sélecteur spécifié. Si vous souhaitez renvoyer tous les éléments correspondants, utilisez plutôt la méthode querySelectorAll().
Pour plus de sélecteurs CSS, vous pouvez consulter notreTutoriel sur les sélecteurs CSSet notreRéférence des sélecteurs CSS。
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version du navigateur qui prend 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 ou plusieurs sélecteurs CSS pour correspondre à l'élément. Vous pouvez sélectionner des éléments par leur id, classe, type, attribut, valeur d'attribut, etc. Pour plusieurs sélecteurs, séparez-les par des virgules, et un élément correspondant est renvoyé. Astuce :Pour plus de sélecteurs CSS, veuillez consulter notreRéférence des sélecteurs CSS。 |
Détails techniques
| Version DOM : | Objet Element 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, renvoie null. Si un sélecteur non valide est spécifié, une exception SYNTAX_ERR est levée. |
Plus d’exemples
Exemples
Modifiez le contenu du premier élément <p> à l'intérieur d'un élément <div> :
x.querySelector("p").innerHTML = "Hello World!";
Essayez-le vous-même »
Exemples
Modifiez le contenu du premier élément enfant ayant class="example" à l'intérieur d'un élément <div> :
x.querySelector(".example").innerHTML = "Hello World!";
Essayez-le vous-même »
Exemples
Modifier le premier élément <p> avec class="example" à l'intérieur d'un élément <div> :
x.querySelector("p.example").innerHTML = "Hello World!";
Essayez-le vous-même »
Exemples
Ajouter une bordure rouge au premier élément <a> à l'intérieur d'un élément <div> qui possède un attribut target :
x.querySelector("a[target]").style.border = "10px solid red";
Essayez-le vous-même »
Exemples
Les exemples suivants illustrent l'utilisation de plusieurs sélecteurs.
Supposons que vous ayez sélectionné deux sélecteurs : les éléments <h2> et <h3>.
Le code suivant ajoutera une couleur d'arrière-plan au premier élément <h2> à l'intérieur d'un élément <div> :
<h2>Un élément h2</h2>
<h3>Un élément h3</h3>
</div>
var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";
Essayez-le vous-même »
Cependant, si l'élément <h3> est placé avant l'élément <h2> à l'intérieur de l'élément <div>, la couleur d'arrière-plan spécifiée sera appliquée à l'élément <h3>.
<h3>Un élément h3</h3>
<h2>Un élément h2</h2>
</div>
var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";
Essayez-le vous-même »
Pages associées
Référence JavaScript :document.querySelector()
Autres extensions
Objet Element