DocumentFragment.querySelector()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 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 Standard # ref-for-dom-parentnode-queryselector① |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- L'interface
DocumentFragment
à laquelle elle appartient.