CKTIS / JavaScript
Eventi `scroll` e `resize` e opzione `passive`
Scegli il destinatario corretto per gli eventi di scorrimento e ridimensionamento e scopri quando un listener passivo impedisce l’annullamento dell’azione predefinita.
Versione: Current web platform; runtime support varies
Sintassi
// ECMAScript 2024 identifies the JavaScript language reference, not the version of these browser APIs.
// The DOM Standard defines the passive listener option, CSSOM View defines scroll and resize,
// and the Resize Observer specification defines ResizeObserver.
document.addEventListener("scroll", onPageScroll);
scrollContainer.addEventListener("scroll", onElementScroll);
window.addEventListener("resize", onViewportResize);
scrollContainer.addEventListener("wheel", onWheel, { passive: true });
scrollContainer.removeEventListener("wheel", onWheel);
const observer = new ResizeObserver(onElementResize);
observer.observe(element);
// When observation is no longer needed:
observer.disconnect();Ascolta scroll su document per lo scorrimento della pagina, oppure direttamente sull’elemento che scorre per seguire i cambiamenti all’interno di un contenitore. scroll segnala un cambio di posizione, causato dall’utente o dal codice. wheel segnala un input che non comporta necessariamente lo scorrimento. Ascolta resize su window quando cambiano le dimensioni del viewport; l’evento non risale nella fase di bubbling. Usa ResizeObserver per osservare le dimensioni di un elemento.
Passa { passive: true } nell’oggetto delle opzioni come terzo argomento di addEventListener(); un semplice booleano in quella posizione imposta capture, non passive. In un listener passivo, preventDefault() non ha effetto e può generare un avviso. { passive: false } permette di annullare l’azione predefinita solo se event.cancelable è true. Gli eventi scroll del documento o di un elemento e resize della finestra generati dal browser non sono annullabili; l’opzione non cambia questo fatto.
Per input come wheel o touchmove, un listener passivo permette al browser di avviare lo scorrimento senza attendere che il listener termini. Se ometti l’opzione, il valore predefinito può dipendere dall’evento, dal destinatario e dal browser. Imposta passive: true se osservi soltanto l’input. Se devi annullare l’azione, imposta passive: false e controlla event.cancelable.
passive non riduce né la frequenza delle chiamate né il loro costo. Mantieni brevi i gestori degli eventi frequenti; se un’operazione costosa deve essere eseguita meno spesso, limitane la frequenza con un timer. requestAnimationFrame() aiuta a sincronizzare gli aggiornamenti visivi con i fotogrammi, ma da solo non garantisce una frequenza inferiore a quella di scroll.
Per rimuovere il listener, chiama removeEventListener() sullo stesso destinatario con lo stesso tipo, la stessa funzione e lo stesso valore di capture; passive non conta nella corrispondenza. Queste API appartengono alla piattaforma web, non a ECMAScript 2024. Verifica il supporto nell’ambiente di esecuzione di destinazione.
Esempi
{
const cases = [
["scroll", false, false],
["resize", false, false],
["wheel", true, true],
["wheel", true, false],
];
for (const [type, cancelable, passive] of cases) {
const target = new EventTarget();
target.addEventListener(type, (event) => event.preventDefault(), { passive });
const event = new Event(type, { cancelable });
target.dispatchEvent(event);
console.log(`${type} cancelable=${event.cancelable} passive=${passive} defaultPrevented=${event.defaultPrevented}`);
}
}Risultato
scroll cancelable=false passive=false defaultPrevented=false resize cancelable=false passive=false defaultPrevented=false wheel cancelable=true passive=true defaultPrevented=false wheel cancelable=true passive=false defaultPrevented=true
Esegui il codice nella console del browser. Gli eventi sintetici non fanno scorrere la pagina né ridimensionano la finestra. Solo l’ultimo caso imposta `defaultPrevented` a `true`: l’evento è annullabile e il listener non è passivo. Il tentativo di annullamento nel listener passivo può generare un avviso separato.
Lezioni correlate
- JavaScript · Lezione 11 · Avanzato · Versione: 4
Fonti
- Document: scroll event
- Element: scroll event
- Window: resize event
- ResizeObserver
- EventTarget: addEventListener() method
- EventTarget: removeEventListener() method
- Event: preventDefault() method
- Element: wheel event
- Event: Event() constructor
- EventTarget: dispatchEvent() method
- HTML Standard: Processing model
- ECMAScript 2024 Language Specification: Hosts and Implementations