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

js
element = documentfragment.querySelector(selectors);

Paramètres

selectors

est une 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 DocumentFragment avec la classe "myclass" est renvoyé :

js
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 :

html
<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