From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/documentfragment/queryselector/index.html | 85 ++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 files/fr/web/api/documentfragment/queryselector/index.html (limited to 'files/fr/web/api/documentfragment/queryselector') diff --git a/files/fr/web/api/documentfragment/queryselector/index.html b/files/fr/web/api/documentfragment/queryselector/index.html new file mode 100644 index 0000000000..6914d21c4a --- /dev/null +++ b/files/fr/web/api/documentfragment/queryselector/index.html @@ -0,0 +1,85 @@ +--- +title: DocumentFragment.querySelector() +slug: Web/API/DocumentFragment/querySelector +tags: + - API + - DOM + - Document + - Méthodes + - fragment +translation_of: Web/API/DocumentFragment/querySelector +--- +
{{ApiRef("DOM")}}
+ +

La méthode DocumentFragment.querySelector() renvoie le premier élément ou null si aucune correspondance n'est trouvée, dans le {{domxref("DocumentFragment")}} (en utilisant la traversée en profondeur des noeuds du document), avec le groupe spécifié de sélecteurs.

+ +

Si le sélecteur correspond à un ID (identifiant) et que cet ID est utilisé plusieurs fois par erreur dans le document, il renvoie le premier élément correspondant.

+ +

Si les sélecteurs spécifiés dans paramètre sont invalides une {{domxref("DOMException")}} avec une valeur SYNTAX_ERR est lancée.

+ +

Syntaxe

+ +
element = documentfragment.querySelector(selectors);
+ +

Paramètres

+ +
+
selectors
+
est une {{domxref("DOMString")}} (chaîne de caractères) contenant un ou plusieurs sélecteurs CSS séparés par des virgules.
+
+ +

Exemples

+ +

Exemple de base

+ +

Dans cet exemple de base, le premier élément dans le {{domxref("DocumentFragment")}} avec la classe "myclass" est renvoyé :

+ +
var el = documentfragment.querySelector(".myclass");
+
+ +

Syntaxe CSS et argument de la méthode

+ +

L'argument chaîne transmis à querySelector doit suivre la syntaxe CSS. Pour faire correspondre un identifiant ou des sélecteurs qui ne suivent pas la syntaxe CSS (utilisant un point-virgule ou un espace inappropriés par exemple), il est obligatoire d'échapper les mauvais caractères avec une double barre oblique inverse :

+ +
<div id="foo\bar"></div>
+<div id="foo:bar"></div>
+
+<script>
+document.querySelector('#foo\bar')    // Ne correspond à rien
+document.querySelector('#foo\\\\bar') // Correspond au premier div
+document.querySelector('#foo:bar')     //  Ne correspond à rien
+document.querySelector('#foo\\:bar')   // Correspond au second div
+</script>
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('Selectors API Level 2', '#queryselector', 'DocumentFragment.querySelector')}}{{Spec2('Selectors API Level 2')}}Pas de changement de {{SpecName('Selectors API Level 1')}}
{{SpecName('Selectors API Level 1', '#queryselector', 'DocumentFragment.querySelector')}}{{Spec2('Selectors API Level 1')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

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