Formations — 1 037 leçons en français

Accueil › JavaScript › La propagation

La propagation

Les événementsintermediaire

Un clic ne concerne pas que l'élément cliqué. L'événement traverse l'arbre, deux fois.

document  →  body  →  ul  →  li  →  button      (capture, descente)
                                       ↓
document  ←  body  ←  ul  ←  li  ←  button      (bouillonnement, remontée)

Par défaut, un écouteur réagit pendant la remontée :

document.body.addEventListener("click", () => console.log("body"));
bouton.addEventListener("click", () => console.log("bouton"));

// Un clic sur le bouton affiche : bouton, puis body

L'ordre dans lequel les écouteurs ont été enregistrés n'y change rien : c'est la position dans l'arbre qui décide.

preventDefault — annuler l'action native

formulaire.addEventListener("submit", (e) => {
  e.preventDefault();      // pas de rechargement de page
  envoyerEnAjax();
});

lien.addEventListener("click", (e) => {
  e.preventDefault();      // le lien n'est pas suivi
});

stopPropagation — arrêter le trajet

menu.addEventListener("click", (e) => {
  e.stopPropagation();     // le clic ne remontera pas jusqu'à document
});

Les deux sont indépendants

preventDefault n'arrête pas la propagation. stopPropagation n'annule pas l'action native. On les appelle souvent ensemble, ce qui entretient la confusion.

Les termes à connaître

Propagation

Le trajet d'un événement dans l'arbre : il descend de la racine jusqu'à la cible, puis remonte jusqu'à la racine. Les écouteurs sont appelés le long de ce trajet.

Capture

La phase descendante, de document vers la cible. Un écouteur ne l'écoute que si on le demande explicitement.

Bouillonnement

La phase remontante, de la cible vers document. C'est la phase par défaut, et celle qui rend la délégation possible.

stopPropagation

Arrête le trajet : les écouteurs des éléments suivants ne seront pas appelés. À utiliser avec parcimonie — il casse les écouteurs des autres.

preventDefault

Annule l'action native du navigateur — suivre un lien, soumettre un formulaire, cocher une case. N'arrête pas la propagation.

Action par défaut

Ce que le navigateur ferait sans JavaScript. Elle s'exécute après les écouteurs, sauf si preventDefault a été appelé.

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.