Formations — 1 037 leçons en français

Accueil › JavaScript › Trouver un élément dans la page

Trouver un élément dans la page

Manipuler la pageintermediaire

Le DOM est la page vue comme un arbre d'objets. On y cherche avec les sélecteurs CSS qu'on connaît déjà.

document.querySelector("#total");          // le premier qui correspond
document.querySelector(".ligne.active");
document.querySelector("form input[type=email]");

document.querySelectorAll(".ligne");       // tous

null, et l'erreur qui va avec

document.querySelector(".absent");              // null
document.querySelector(".absent").textContent;  // 💥 TypeError

Cannot read properties of null est l'erreur la plus fréquente du DOM. Elle veut presque toujours dire l'une de ces deux choses : le sélecteur est faux, ou le script s'exécute avant que l'élément existe.

Une NodeList n'est pas un tableau

const lignes = document.querySelectorAll(".ligne");

lignes.length          // ✅
lignes.forEach(…)      // ✅
lignes.map(…)          // ❌ pas une fonction

[...lignes].map(…)     // ✅

Convertissez dès que vous voulez map, filter ou reduce.

Chercher dans une partie de la page

const form = document.querySelector("form");
form.querySelector("input");     // seulement à l'intérieur du formulaire

Toute méthode de recherche existe aussi sur un élément, pas seulement sur document. C'est ce qui permet d'écrire des composants qui ne se marchent pas dessus.

Les termes à connaître

DOM

« Document Object Model » : la représentation de la page sous forme d'arbre d'objets, que JavaScript peut lire et modifier. Ce n'est pas le fichier HTML, c'est ce que le navigateur en a construit.

querySelector

Rend le premier élément correspondant à un sélecteur CSS, ou null. Le sélecteur est exactement celui qu'on écrirait dans une feuille de style.

querySelectorAll

Rend tous les éléments correspondants, dans une NodeList. Jamais null : une liste vide si rien ne correspond.

NodeList

Une liste d'éléments qui ressemble à un tableau mais n'en est pas un. Elle a forEach et length, mais ni map ni filter.

Élément

Un nœud du DOM correspondant à une balise. Tous les nœuds ne sont pas des éléments : le texte et les commentaires en sont aussi.

closest

Remonte depuis un élément jusqu'au premier ancêtre — lui-même compris — qui correspond au sélecteur. C'est la clé de la délégation d'événements.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.