Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
JavaScript

Sélectionner avec querySelector et querySelectorAll

Sélectionner avec querySelector et querySelectorAll. Dans cette leçon du cours JavaScript, vous apprendrez à : sélectionner des éléments avec n'importe quel sélecteur CSS ; distinguer querySelector (u...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Sélectionner avec querySelector et querySelectorAll. Dans cette leçon du cours JavaScript, vous apprendrez à : 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.

Chapitre 12 — Le DOM : parcours et mise à jour · Sélectionner avec querySelector et querySelectorAll

🎯 Objectifs de la leçon
• 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.

Les sélecteurs CSS les plus utiles
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
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"): true si 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 (ou null). Très utile avec les événements (leçon 13.5).
⚠️ Attention
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").
ℹ️ À retenir
• 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) :

  1. 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 ?
  2. Comptez les liens qui mènent vers un autre site (adresse commençant par http). Mettez-leur ensuite target="_blank" avec forEach.
  3. Récupérez les textes de toutes les cases cochées sous forme de tableau. Pourquoi faut-il convertir la NodeList ?
  4. Votre page contient deux cartes de cours. Comment obtenir les <li> de la seconde carte seulement ?
  5. À partir d'un <li>, retrouvez la carte qui le contient avec closest. Que renvoie closest si l'élément lui-même correspond au sélecteur ?
  6. Comparez document.querySelector(".absent") et document.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é ?