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

Compatibilité des navigateurs

BCD tables only load in the browser

Voir également