Formations — 1 037 leçons en français

Accueil › JavaScript › La délégation d'événements

La délégation d'événements

Les événementsintermediaire

Le problème

// ❌ un écouteur par bouton, et rien pour les boutons ajoutés ensuite
document.querySelectorAll(".supprimer").forEach((b) => {
  b.addEventListener("click", supprimer);
});

Deux défauts : mille boutons font mille écouteurs, et tout bouton créé après cette ligne n'en a aucun.

La solution

Un seul écouteur, sur le conteneur. L'événement remonte jusqu'à lui, et on retrouve l'enfant concerné :

liste.addEventListener("click", (e) => {
  const bouton = e.target.closest(".supprimer");
  if (!bouton) return;                        // le garde, obligatoire

  const ligne = bouton.closest("li");
  supprimer(Number(ligne.dataset.id));
});

Trois lignes qui couvrent tous les boutons — ceux d'aujourd'hui et ceux de demain.

Pourquoi closest et pas e.target

<button class="supprimer"><span>🗑</span> Supprimer</button>

Un clic sur l'icône donne e.target égal au <span>. Un test e.target.matches(".supprimer") échouerait — et seulement quand on clique sur l'icône, ce qui donne un bug intermittent très désagréable à diagnostiquer.

closest remonte jusqu'au bouton, où qu'on ait cliqué dedans.

Le garde

if (!bouton) return;

closest rend null quand rien ne correspond — un clic dans la marge du conteneur, par exemple. C'est la première ligne de tout écouteur délégué.

Les termes à connaître

Délégation

Poser un seul écouteur sur un conteneur plutôt qu'un par enfant, et retrouver l'enfant concerné à partir de l'événement. Possible grâce au bouillonnement.

closest

Remonte depuis e.target jusqu'au premier ancêtre correspondant au sélecteur, lui-même compris. C'est la pièce centrale de la délégation.

Élément dynamique

Un élément ajouté après le chargement. Un écouteur posé à l'avance sur lui est impossible ; un écouteur sur son conteneur le couvre d'office.

Garde de délégation

Le test qui écarte les clics ne concernant pas la cible attendue. Sans lui, un clic dans la marge du conteneur déclenche le traitement.

Action déclarative

Un attribut data-action qui nomme ce que le bouton fait. Un seul écouteur lit cet attribut et appelle le bon traitement.

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.