À propos de ce cours
Chapitre 12 — Le DOM : parcours et mise à jour · Sélectionner avec querySelector et querySelectorAll
• sélectionner des éléments avec n'importe quel sélecteur CSS ;
• distinguer
querySelector (un élément) et querySelectorAll (une liste) ;• chercher à l'intérieur d'un élément plutôt que dans tout le document ;
• utiliser
matches et closest. 1. Deux méthodes, un sélecteur CSS
const titre = document.querySelector("h1"); // le premier <h1>, ou null
const cartes = document.querySelectorAll(".carte"); // tous les .carte, dans une NodeList
// Le même sélecteur que dans votre fichier CSS :
document.querySelector("#menu a.actif");
document.querySelectorAll('input[type="checkbox"]:checked');
querySelector renvoie le premier élément correspondant dans l'ordre du document, ou null. querySelectorAll renvoie tous les éléments dans une NodeList figée, éventuellement vide (jamais null).
Ce sont les méthodes les plus utilisées aujourd'hui : elles remplacent avantageusement les getElementsBy…, sauf getElementById
qui reste un peu plus rapide pour un identifiant.

Figure 1 — Tous les sélecteurs CSS sont utilisables.
2. Exemples
📄 l4_queryselector.html
<!DOCTYPE html>
<html lang="fr">
<head><meta charset="UTF-8"><link rel="stylesheet" href="style.css"></head>
<body>
<nav id="menu">
<a href="/" class="lien actif">Accueil</a>
<a href="/cours" class="lien">Cours</a>
<a href="https://developer.mozilla.org" class="lien externe">MDN</a>
</nav>
<section class="carte" data-module="M107">
<h3>Programmation JavaScript</h3>
<ul>
<li>Les variables</li>
<li class="important">Le DOM</li>
<li>Les événements</li>
</ul>
<input type="checkbox" checked> Terminé
</section>
<pre id="sortie"></pre>
<script>
const lignes = [];
const q = (sel) => document.querySelector(sel);
const qa = (sel) => document.querySelectorAll(sel);
const decrire = (el) => el ? `<${el.tagName.toLowerCase()}> « ${el.textContent.trim().slice(0, 25)} »` : "null";
// querySelector : le PREMIER élément correspondant (ou null)
lignes.push(`querySelector("#menu a") → ${decrire(q("#menu a"))}`);
lignes.push(`querySelector(".lien.externe") → ${decrire(q(".lien.externe"))}`);
lignes.push(`querySelector('[href^="https"]') → ${decrire(q('[href^="https"]'))}`);
lignes.push(`querySelector("ul > li:last-child") → ${decrire(q("ul > li:last-child"))}`);
lignes.push(`querySelector("li:nth-child(2)") → ${decrire(q("li:nth-child(2)"))}`);
lignes.push(`querySelector("[data-module] h3") → ${decrire(q("[data-module] h3"))}`);
lignes.push(`querySelector("input:checked") → ${decrire(q("input:checked"))}`);
lignes.push(`querySelector(".inexistant") → ${decrire(q(".inexistant"))}`);
// querySelectorAll : TOUS les éléments, dans une NodeList
const liens = qa("#menu .lien");
lignes.push("");
lignes.push(`querySelectorAll("#menu .lien") → ${liens.constructor.name} de ${liens.length} éléments`);
liens.forEach((a, i) => lignes.push(` [${i}] ${a.textContent}`));
lignes.push(`Array.isArray(liens) ? ${Array.isArray(liens)} → [...liens].map(...) : ${[...liens].map((a) => a.textContent).join(" | ")}`);
// Chercher à l'intérieur d'un élément
const carte = q(".carte");
lignes.push("");
lignes.push(`carte.querySelectorAll("li").length = ${carte.querySelectorAll("li").length}`);
// matches et closest
const leDom = q(".important");
lignes.push(`leDom.matches(".carte li") ? ${leDom.matches(".carte li")}`);
lignes.push(`leDom.closest("section").dataset.module = ${leDom.closest("section").dataset.module}`);
// Un sélecteur invalide provoque une erreur
try { q("li:premier"); } catch (e) { lignes.push(`\nquerySelector("li:premier") → ${e.name}`); }
document.querySelector("#sortie").textContent = lignes.join("\n");
</script>
</body>
</html>

Résultat des sélections
Parcourir une NodeList
Contrairement à une HTMLCollection, une NodeList possède forEach. Pour les autres méthodes
des tableaux (map, filter…), on la convertit : [...liste] ou Array.from(liste).
Chercher dans un élément
Les deux méthodes existent aussi sur chaque élément : carte.querySelectorAll("li") ne cherche que dans la carte.
C'est plus rapide et surtout plus sûr quand la page contient plusieurs blocs semblables.
matches et closest
element.matches("sélecteur"):truesi l'élément correspond au sélecteur.element.closest("sélecteur"): remonte depuis l'élément lui-même vers ses ancêtres et renvoie le premier qui correspond (ounull). Très utile avec les événements (leçon 13.5).
Un sélecteur mal écrit (
"li:premier") déclenche une SyntaxError qui arrête le script.
Un sélecteur correct qui ne trouve rien renvoie simplement null: testez le résultat avant de l'utiliser.
Si un identifiant commence par un chiffre (id="2025"), le sélecteur "#2025" est invalide : utilisez getElementById("2025"). •
querySelector(css): le premier élément ou null; querySelectorAll(css): une NodeList figée.• N'importe quel sélecteur CSS :
#id, .classe, [attribut], :checked, ul > li…• On peut chercher dans un élément :
element.querySelector(...). •
matches teste un élément ; closest trouve l'ancêtre le plus proche.🛠 Activité 4 — Le sélecteur détective
Mission : Reprenez une page de votre site de stage (ou la page de l'exemple) et répondez à chaque question par un seul appel à querySelector ou querySelectorAll, testé dans la console.
Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :
- Sélectionnez le deuxième lien du menu. Proposez deux sélecteurs différents. Lequel résiste le mieux si l'on ajoute un lien en tête du menu ?
- Comptez les liens qui mènent vers un autre site (adresse commençant par
http). Mettez-leur ensuitetarget="_blank"avecforEach. - Récupérez les textes de toutes les cases cochées sous forme de tableau. Pourquoi faut-il convertir la NodeList ?
- Votre page contient deux cartes de cours. Comment obtenir les
<li>de la seconde carte seulement ? - À partir d'un
<li>, retrouvez la carte qui le contient avecclosest. Que renvoieclosestsi l'élément lui-même correspond au sélecteur ? - Comparez
document.querySelector(".absent")etdocument.querySelectorAll(".absent")quand aucun élément n'a cette classe. Quelle vérification écrivez-vous dans chaque cas avant d'utiliser le résultat ?
Je vérifie / je rends :
- ☐ Un fichier texte avec vos sélecteurs, chacun suivi du résultat obtenu.
← L'accès aux éléments HTML en JavaScriptParcourir l'arbre du DOM : parents, enfants et frères →
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !