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
documentvers 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
preventDefaulta été appelé.
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.