CKTIS / JavaScript
Eventi del browser e propagazione
Gli eventi permettono di reagire alle azioni dell’utente e ai cambiamenti di stato della pagina. Scopri cattura, destinazione e risalita, la differenza tra annullare l’azione predefinita e fermare la propagazione e gli eventi di ciclo di vita, visibilità, scorrimento, ridimensionamento e input.
Versione: 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.
Sintassi
target.addEventListener(type, handler, options);
target.removeEventListener(type, handler, options);
target.dispatchEvent(event);Modello e ambito
Gli eventi del browser fanno parte delle API dell’ambiente ospite, non della sintassi ECMAScript. Lo standard DOM definisce il modello degli eventi, il loro invio e la loro propagazione, oltre alle opzioni dei listener. Lo standard HTML specifica, tra l’altro, quando si verificano DOMContentLoaded e load e quando vengono generati input e change nei controlli dei moduli. Non associare queste API a un’edizione di ECMAScript. Node 24 non attesta il supporto delle API del browser. Verifica la compatibilità nei browser di destinazione.
Propagazione e annullamento
addEventListener(type, handler, options) registra un gestore. L’evento passa per la cattura sugli antenati, la destinazione e, se bubbles è vero, la risalita sugli antenati. target indica la destinazione; currentTarget, l’oggetto del listener attivo. stopPropagation() ferma la propagazione senza saltare i listener rimanenti nella serie di chiamate in corso. Se però un listener di cattura sulla destinazione chiama stopPropagation(), la serie separata di chiamate ai listener senza cattura sulla stessa destinazione non ha luogo. stopImmediatePropagation() salta anche i listener rimanenti nella serie in corso. preventDefault() annulla l’azione predefinita solo se l’evento è annullabile e il listener non è passivo. Non ferma la propagazione.
Ciclo di vita e visibilità
DOMContentLoaded su document: terminano l’analisi e gli script che lo ritardano, non necessariamente il caricamento delle risorse. load su window attende anche le risorse che lo ritardano. pageshow e pagehide coprono la cache avanti/indietro: controlla persisted. A visibilitychange su document, leggi document.visibilityState. Nascosta non vuol dire chiusa; unload non garantisce il salvataggio finale.
Scorrimento, dimensioni e input
scroll riguarda l’oggetto che scorre, resize su window le dimensioni del viewport. Non tutti gli eventi risalgono. Mantieni leggeri i gestori frequenti. input segnala una modifica dell’utente, change la conferma secondo il controllo; assegnare .value non genera nessuno dei due. Distingui keydown, eventi del puntatore e click semantico; non contare solo sul mouse.
Gestione dei listener
once rimuove il listener prima della prima chiamata al suo gestore. Se il gestore invia in modo sincrono un altro evento dello stesso tipo, il listener rimosso non gestisce quell’evento. passive rende inefficace preventDefault(), signal consente la rimozione per interruzione. Per removeEventListener conserva tipo, riferimento alla funzione e valore di capture. Nell’esempio dispatchEvent() è sincrono: false indica annullamento, non arresto della propagazione.
Identificatori di riferimento trattati in questa voce: Page lifecycle, visibility, scroll/resize and input events.
Esempi
(() => {
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);
})();Risultato
capture > target > bubble false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- 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