ParentNode.querySelectorAll()
Renvoie une NodeList
représentant une liste d'éléments avec l'élément courant comme racine et qui correspondent au groupe de sélecteurs spécifiés.
Syntaxe
elementList = document.querySelectorAll(selectors);
où
elementList
est uneNodeList
non-directe d'objetselement
.selectors
est une chaîne de caractères (string) contenant un ou plusieurs sélecteurs CSS séparés par des virgules.
La NodeList
retournée contiendra tous les éléments dans le document qui correspondent à l'un des sélecteurs spécifiés. Si la chaîne selectors
contient un pseudo-element CSS, la elementList
retournée sera vide.
Exemples
Cet exemple renvoie une liste de tous les éléments div
d'un document
avec une classe "note
" ou "alert
" :
var matches = document.querySelectorAll("div.note, div.alert");
Notes
Renvoie une NodeList
non directe de tous les noeuds éléments correspondant.
Lance une exception SYNTAX_ERR
si le groupe de sélecteurs spécifié est invalide.
querySelectorAll()
fut introduite dans l'API WebApps.
L'argument chaîne passé à querySelectorAll()
doit suivre la syntaxe CSS. Voir document.querySelector
pour des exemples concrets.
Spécifications
Spécification | Statut | Commentaire |
---|---|---|
Selectors API Level 2 La définition de 'ParentNode.querySelectorAll()' dans cette spécification. |
Obsolete | Pas de changement. |
DOM4 La définition de 'ParentNode.querySelectorAll()' dans cette spécification. |
Obsolete | Définition initiale. |