From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../fr/web/api/parentnode/queryselector/index.html | 105 +++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 files/fr/web/api/parentnode/queryselector/index.html (limited to 'files/fr/web/api/parentnode/queryselector') diff --git a/files/fr/web/api/parentnode/queryselector/index.html b/files/fr/web/api/parentnode/queryselector/index.html new file mode 100644 index 0000000000..62844d47b1 --- /dev/null +++ b/files/fr/web/api/parentnode/queryselector/index.html @@ -0,0 +1,105 @@ +--- +title: ParentNode.querySelector() +slug: Web/API/ParentNode/querySelector +tags: + - API + - DOM + - Draft + - Method + - NeedsExample + - ParentNode + - Reference + - Selectors + - querySelector +translation_of: Web/API/ParentNode/querySelector +--- +

{{APIRef("DOM")}}{{Draft}}

+ +

Le mixin {{DOMxRef("ParentNode")}} définit la méthode querySelector()  comme renvoyant un {{DOMxRef("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 {{DOMxRef("ParentNode.querySelectorAll", "querySelectorAll()")}} .

+ +
+

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

+
+ +

Syntaxe

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

Paramètres

+ +
+
sélécteurs
+
Un {{DOMxRef("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 {{anch("Escaping special characters")}} pour plus d'informations.

+
+ +

Retourner une valeur

+ +

Le premier {{DOMxRef("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écificationStatutCommentaire
{{SpecName("DOM WHATWG", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("DOM WHATWG")}}Niveau de vie
{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("Selectors API Level 2")}}Pas de changement
{{SpecName("DOM4", "#dom-parentnode-queryselector", "ParentNode.querySelector()")}}{{Spec2("DOM4")}}Définition initiale
{{SpecName("Selectors API Level 1", "#interface-definitions", "document.querySelector()")}}{{Spec2("Selectors API Level 1")}}Définition originale
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("api.ParentNode.querySelector")}}

+ +

Voir également

+ + -- cgit v1.2.3-54-g00ecf