DOM HTML querySelector()Méthode

HTML 元素对象参考手册Objet Element

Exemples

Modifiez le contenu textuel du premier élément enfant de l'élément <div> avec class="demo" :

var x = document.getElementById("myDIV"); x.querySelector(".demo").innerHTML = "Bonjour le monde !";

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

element.querySelector(Sélecteur CSS)

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> :

var x = document.getElementById("myDIV");
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> :

var x = document.getElementById("myDIV");
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> :

var x = document.getElementById("myDIV");
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 :

var x = document.getElementById("myDIV");
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> :

<div id="myDIV">
  <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>.

<div id="myDIV">
  <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()


HTML 元素对象参考手册Objet Element

Autres extensions