ParentNode.querySelector()

Brouillon: Cette page n'est pas terminée.

Le mixin ParentNode définit la méthode querySelector()  comme renvoyant un Element représentant le premier élément correspondant au groupe de sélecteurs spécifié qui sont les descendants de l'objet sur lequel la méthode a été appelée.

Si vous avez besoin de tous les éléments correspondant à la liste de sélecteurs, utilisez plutôt querySelectorAll() .

Remarque: Cette méthode est implémentée comme Document.querySelector(), DocumentFragment.querySelector() et Element.querySelector().

Syntaxe

élément = parentNode.querySelector(sélécteurs);

Paramètres

sélécteurs
Un DOMString contenant un ou plusieurs sélecteurs à comparer. Cette chaîne doit être une compound selector list valide prise en charge par le navigateur; sinon, une exception SyntaxError est levée. Voir Localisation des éléments DOM à l'aide de sélecteurs pour plus d'informations sur l'utilisation des sélecteurs pour identifier les éléments. Plusieurs sélecteurs peuvent être spécifiés en les séparant à l'aide de virgules.

Remarque: Les caractères qui ne font pas partie de la syntaxe CSS standard doivent être échappés à l'aide d'un caractère barre oblique inverse. Étant donné que JavaScript utilise également l'échappement arrière, une attention particulière doit être apportée lors de l'écriture de littéraux de chaîne à l'aide de ces caractères. Voir Escaping special characters pour plus d'informations.

Retourner une valeur

Le premier Element qui correspond à au moins l'un des sélecteurs spécifiés ou null si aucun élément de ce type n'est trouvé.

Remarque: Si le spécifié sélécteurs inclut un pseudo-élément CSS,  la valeur renvoyée est toujours null.

Des exceptions

SyntaxError
La syntaxe de la chaîne sélécteurs spécifiée n'est pas valide.

Caractéristiques

Spécification Statut Commentaire
DOM
La définition de 'ParentNode.querySelector()' dans cette spécification.
Standard évolutif Niveau de vie
Selectors API Level 2
La définition de 'ParentNode.querySelector()' dans cette spécification.
Obsolete Pas de changement
DOM4
La définition de 'ParentNode.querySelector()' dans cette spécification.
Obsolete Définition initiale
Selectors API Level 1
La définition de 'document.querySelector()' dans cette spécification.
Obsolete Définition originale

Compatibilité des navigateurs

No compatibility data found for api.ParentNode.querySelector.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.

Voir également