ParentNode.querySelector()

Cette traduction est incomplète. Aidez-nous à traduire cet article depuis l’anglais

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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
querySelectorChrome Support complet 1Edge Support complet 12Firefox Support complet 3.5IE Support complet 9
Notes
Support complet 9
Notes
Notes Internet Explorer 8 only supported CSS2 selectors.
Opera Support complet 10Safari Support complet 4WebView Android Support complet ≤37Chrome Android Support complet 18Firefox Android Support complet OuiOpera Android Support complet 10.1Safari iOS Support complet 3.2Samsung Internet Android Support complet 1.0

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir également