Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ResizeObserverEntry — l’elemento osservato e le sue dimensioni

ResizeObserverEntry descrive un elemento in una notifica di ResizeObserver. La proprietà target identifica l’elemento, mentre contentRect ne fornisce le dimensioni. Scopri la differenza tra il riquadro del contenuto di un elemento HTML e il riquadro di delimitazione di un SVG.

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

new ResizeObserver((entries) => {
  for (const entry of entries) {
    const element = entry.target;
    const { width, height } = entry.contentRect;
  }
}).observe(element);

ResizeObserverEntry è un record fornito nell’array entries alla funzione di callback di un ResizeObserver. Una chiamata può fornire record per più elementi osservati; quindi, elabora l’array invece di supporre che contenga un solo risultato.

ResizeObserverEntry.target è una proprietà di sola lettura che fa riferimento all’Element o SVGElement osservato. Consente di associare una misurazione all’elemento corretto. Il riferimento in sé è di sola lettura, ma l’elemento a cui si riferisce può comunque essere modificato.

ResizeObserverEntry.contentRect è una proprietà di sola lettura che restituisce un DOMRectReadOnly. Per un elemento HTML descrive il riquadro del contenuto, esclusi padding e bordi. Per un elemento grafico SVG senza un riquadro di layout CSS associato, descrive il suo riquadro di delimitazione. Per un elemento <svg> esterno che ha un riquadro di layout CSS, può invece descrivere il suo riquadro del contenuto CSS. width e height sono dimensioni, non la misura esterna dell’elemento HTML. Questa proprietà legacy è mantenuta per compatibilità; le proprietà più recenti, come contentBoxSize e borderBoxSize, hanno requisiti di supporto distinti.

Questa è un’interfaccia Web API, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che il supporto di base è ampiamente disponibile da luglio 2020; la disponibilità di proprietà aggiuntive può variare. Node 24 non dimostra il supporto nei browser. Le notifiche sono asincrone. Evita modifiche alle dimensioni nella callback che innescano all’infinito altre notifiche.

Esempi

(() => {
  if (typeof ResizeObserver === "undefined") {
    throw new Error("ResizeObserver is not supported");
  }

  const box = document.createElement("div");
  box.id = "resize-demo";
  box.style.cssText = "display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 10px; border: 2px solid black;";
  document.body.append(box);

  const observer = new ResizeObserver((entries) => {
    for (const entry of entries) {
      const { width, height } = entry.contentRect;
      console.log(`${entry.target.id}: ${width} x ${height}`);
    }
    observer.disconnect();
    box.remove();
  });

  observer.observe(box);
})();

Risultato

resize-demo: 120 x 60

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