Document.querySelectorAll()

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Sommaire

Renvoie la liste des éléments dans le document (en partant du premier niveau du html et ordonné comme les éléments du document) qui correspondent au groupe de sélecteurs passés en paramètre. L'objet retourné est une collection de noeuds NodeList.

Syntaxe

elements = document.querySelectorAll(selecteurs);

Le NodeList renvoyé contiendra tous les élements du document qui correspondent au groupe de sélecteurs passés en paramètre.Si la chaîne selecteurs contients un pseudo-element, la collection elementList retournée sera vide.

Exemple

Cet exemple renvoie la liste de tous les éléments div du document dont l'attribut de classe a pour valeur "note" ou "alert":

var matches = document.querySelectorAll("div.note, div.alert");

Notes

Renvois un élément de type  NodeList de tous les noeuds correspondant.

Relève une exception SYNTAX_ERR si le sélecteur spécifié est invalide.

querySelectorAll() a été ajouté dans l'API WebApps.

Les navigateurs sous Webkit ont un bug lorsque la chaine de caractère du sélecteur contient un pseudo-element, une elementList est retournée contenant <html>.

La chaine de caractère passée en argument à la méthode querySelectorAll doit suivre la syntaxe CSS. Pour des exemples concrets, voir ce lien document.querySelector.

Compatibilité avec les navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Support de base 1 3.5 (1.9.1) 9
8 (CSS2 selectors only)
10 3.2 (525.3)
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support de base 2.1 yes 9 10.0 3.2

Specification

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : DCK, micetf
 Dernière mise à jour par : DCK,