DocumentFragment.querySelector()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode DocumentFragment.querySelector() renvoie le premier élément ou null si aucune correspondance n'est trouvée, dans le 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 DOMException avec une valeur SYNTAX_ERR est lancée.
Syntaxe
element = documentfragment.querySelector(selectors);
Paramètres
Exemples
Exemple de base
Dans cet exemple de base, le premier élément dans le 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
| Specification |
|---|
| DOM # ref-for-dom-parentnode-queryselector① |
Compatibilité des navigateurs
Chargement…
Voir aussi
- L'interface
DocumentFragmentà laquelle elle appartient.