Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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