CKTIS / JavaScript
Evento `resize` di `Window`
Ascolta `resize` su `window` per reagire alle variazioni delle dimensioni del viewport di layout. Usa `ResizeObserver` per seguire le dimensioni di un singolo elemento.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
window.addEventListener("resize", handler);
window.removeEventListener("resize", handler);
// Alternative: assign a single handler property.
window.onresize = handler;
window.onresize = null;Il browser genera resize su window quando cambiano le dimensioni del viewport di layout, cioè dell’area usata per calcolare il layout della pagina. È un’API della piattaforma web, non una funzionalità di ECMAScript. Il browser fornisce un semplice Event, che non contiene le nuove dimensioni. L’evento non risale per bubbling e non si può annullare con preventDefault().
Leggi la larghezza e l’altezza correnti da window.innerWidth e window.innerHeight. I valori sono in pixel CSS e includono rispettivamente la larghezza della barra di scorrimento verticale e l’altezza di quella orizzontale, se presenti. Se all’app servono subito le dimensioni, chiama la funzione di aggiornamento durante l’inizializzazione: registrare il listener non la chiama. Durante il ridimensionamento, l’evento può ripetersi; evita quindi operazioni costose a ogni chiamata.
addEventListener("resize", handler) consente di registrare più listener distinti. Quando un listener non serve più, rimuovilo con removeEventListener() usando lo stesso tipo di evento, lo stesso riferimento alla funzione e lo stesso valore di capture. Assegnare un valore a window.onresize sostituisce solo il gestore impostato tramite quella proprietà, non i listener aggiunti con addEventListener(); assegnare null rimuove quel gestore.
Usa ResizeObserver per osservare un singolo elemento: le sue dimensioni possono cambiare anche se quelle del viewport di layout restano invariate. Per seguire le dimensioni della parte visibile della pagina, ascolta l’evento separato resize su window.visualViewport se l’API è disponibile.
Esempi
{
const target = typeof window === "undefined" ? new EventTarget() : window;
function reportResize(event) {
console.log(`${event.type}: bubbles=${event.bubbles}, cancelable=${event.cancelable}`);
}
target.addEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
target.removeEventListener("resize", reportResize);
target.dispatchEvent(new Event("resize"));
}Risultato
resize: bubbles=false, cancelable=false
Esegui il codice nella console del browser o con Node.js 24. Nel browser il codice usa `window`, mentre in Node.js usa un oggetto `EventTarget` indipendente. Il primo evento sintetico invoca il listener in modo sincrono e stampa una riga. Il secondo viene inviato dopo la rimozione del listener, quindi il codice non stampa altro. Nessuno dei due modifica le dimensioni del viewport.
Lezioni correlate
- JavaScript · Lezione 27 · Intermedio · Versione: 3