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 exceptionSyntaxError
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
- Localisation des éléments DOM à l'aide de sélecteurs
- Extraits de code pour
querySelector()
- Sélecteurs d'attributs dans le guide CSS
- Sélecteurs d'attributs dans la zone d'apprentissage MDN
- Cette méthode est disponible
Element.querySelector()
,Document.querySelector()
, etDocumentFragment.querySelector()