CKTIS / JavaScript
Événements du navigateur et propagation
Les événements permettent de réagir aux actions de l’utilisateur et aux changements d’état de la page. Découvrez la capture, la cible et la remontée, la différence entre annuler l’action par défaut et arrêter la propagation, ainsi que les événements de cycle de vie, de visibilité, de défilement, de redimensionnement et de saisie.
Version : Web APIs defined by web standards, not ECMAScript editions. Check support in target browsers; Node 24 in the repository does not establish browser API support.
Syntaxe
target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);Modèle et portée
Les événements du navigateur relèvent des API de l’environnement hôte, pas de la syntaxe ECMAScript. La norme DOM définit le modèle d’événements, leur distribution, leur propagation et les options des écouteurs. La norme HTML précise notamment quand se déclenchent DOMContentLoaded, load et les événements input et change des contrôles de formulaire. Ne rattachez pas ces API à une édition d’ECMAScript. Node 24 ne prouve pas la prise en charge des API du navigateur. Vérifiez leur compatibilité avec les navigateurs cibles.
Propagation et annulation
addEventListener(type, handler, options) inscrit un gestionnaire. L’événement passe par la capture chez les ancêtres, la cible puis, si bubbles est vrai, remonte chez les ancêtres. target désigne la cible, currentTarget l’objet de l’écouteur actif. stopPropagation() arrête la propagation sans empêcher l’appel des écouteurs restants dans la série en cours. Toutefois, si un écouteur de capture sur la cible appelle stopPropagation(), la série distincte d’appels aux écouteurs sans capture sur cette même cible n’a pas lieu. stopImmediatePropagation() empêche aussi l’appel des écouteurs restants dans la série en cours. preventDefault() annule l’action par défaut si l’événement est annulable et l’écouteur non passif. Il n’arrête pas la propagation.
Cycle de vie et visibilité
DOMContentLoaded sur document : l’analyse et les scripts qui le retardent sont terminés, pas forcément le chargement des ressources. load sur window attend aussi les ressources qui le retardent. pageshow et pagehide couvrent le cache de navigation arrière/avant : vérifiez persisted. À visibilitychange sur document, lisez document.visibilityState. Masquée ne veut pas dire fermée ; unload ne garantit pas une sauvegarde finale.
Défilement, taille et saisie
scroll concerne la cible défilée ; resize sur window, la taille de la zone d’affichage. Tout ne remonte pas. Gardez les gestionnaires fréquents légers. input signale une édition par l’utilisateur, change sa validation selon le contrôle ; affecter .value ne déclenche ni l’un ni l’autre. Distinguez keydown, les événements de pointeur et le click sémantique. Ne comptez pas que sur la souris.
Gestion des écouteurs
once retire l’écouteur avant le premier appel de son gestionnaire. Si ce gestionnaire déclenche de façon synchrone un autre événement du même type, l’écouteur retiré ne le traite pas. passive rend preventDefault() inopérant ; signal permet le retrait par interruption. Pour removeEventListener, gardez le type, la référence de fonction et la valeur de capture. Dans l’exemple synchrone, dispatchEvent() renvoie false pour une annulation, pas un arrêt de propagation.
Identifiants de référence couverts par cette entrée : Page lifecycle, visibility, scroll/resize and input events.
Exemples
(() => {
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const log = [];
parent.addEventListener('demo', () => log.push('capture'), { capture: true });
child.addEventListener('demo', event => {
log.push('target');
event.preventDefault();
});
parent.addEventListener('demo', () => log.push('bubble'));
const accepted = child.dispatchEvent(new Event('demo', {
bubbles: true,
cancelable: true
}));
console.log(log.join(' > '));
console.log(accepted);
})();Résultat
capture > target > bubble false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- DOM Standard — Events, dispatch, propagation, and listener options
- Official reference — developer.mozilla.org: API / PageTransitionEvent
- HTML Standard — End of parsing, DOMContentLoaded, and load
- MDN Web Docs — Document: visibilitychange event
- MDN Web Docs — Window: unload event
- CSSOM View Module — Scroll and resize event processing
- HTML Standard — Common input element events
- UI Events — Keyboard and click events
- Pointer Events