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);
où
elementsest une collection non directeNodeListd'element.selecteursest une chaîne qui contient un ou plusieurs sélecteurs CSS séparés par des virgules.
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 |