Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ResizeObserver — osservare le dimensioni di un elemento

ResizeObserver segnala le dimensioni degli elementi anche quando la finestra non cambia dimensione. Permette a un componente di reagire allo spazio disponibile senza interrogare ripetutamente il DOM.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const observer = new ResizeObserver((entries, observer) => { /* handle sizes */ });
observer.observe(element, { box: "content-box" });
observer.unobserve(element);
observer.disconnect();

ResizeObserver è un'API del browser, non una funzionalità ECMAScript; Node 24 non ne conferma la disponibilità. L'evento resize viene generato su Window quando cambiano le dimensioni della finestra, mentre ResizeObserver segnala le variazioni di dimensione di un elemento osservato. Le notifiche sono asincrone e vengono raggruppate durante il rendering.

observe() osserva content-box per impostazione predefinita. border-box include padding e bordi, mentre device-pixel-content-box misura il contenuto in pixel interi del dispositivo. L'opzione box seleziona il trigger, non filtra i campi del risultato.

Il callback riceve entries e l'observer. Una voce contiene target, contentRect e array di dimensioni come contentBoxSize; i relativi inlineSize e blockSize dipendono dalla modalità di scrittura. contentRect.width e contentRect.height descrivono le dimensioni fisiche del contenuto.

Evita modifiche alle dimensioni nel callback che creano cicli di retroazione: il browser può segnalare un errore di ciclo di osservazione del ridimensionamento. Le sole trasformazioni CSS non attivano notifiche. unobserve(element) interrompe una singola osservazione; disconnect() le interrompe tutte. Verifica la disponibilità dell'API e delle opzioni necessarie nei browser di destinazione.

Esempi

(() => {
  if (typeof ResizeObserver !== "function") {
    throw new Error("ResizeObserver unavailable");
  }

  const box = document.createElement("div");
  box.style.cssText = "all: initial; display: block; position: fixed; width: 120px; height: 40px; padding: 0; border: 0; box-sizing: content-box; writing-mode: horizontal-tb;";
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box, { box: "content-box" });
})();

Risultato

120 x 40

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