Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ResizeObserverEntry: elemento osservato e rettangolo del contenuto

Usa `target` per identificare l’elemento a cui si riferisce la voce e `contentRect` per leggere le dimensioni rilevate, senza padding né bordi per un elemento HTML.

Versione: Current web platform; runtime support varies

Sintassi

entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.height

Durante il rendering, il browser passa un array di voci ResizeObserverEntry alla funzione di callback di ResizeObserver. La proprietà entry.target è di sola lettura e fa riferimento all’elemento osservato, non a una copia. Se osservi più elementi, confronta target con un riferimento noto usando ===.

entry.contentRect è un oggetto DOMRectReadOnly che conserva la misura della notifica e non si aggiorna in tempo reale. Per un elemento HTML, width e height sono la larghezza e l’altezza fisiche del riquadro del contenuto in pixel CSS, senza padding né bordi. Per un elemento grafico SVG senza un riquadro di layout CSS, la misura descrive il suo rettangolo di delimitazione. Non confonderlo con getBoundingClientRect(), che per HTML restituisce un rettangolo che racchiude i riquadri di bordo rispetto al viewport.

contentRect è mantenuta per garantire la retrocompatibilità. Se ti servono le dimensioni logiche, usa contentBoxSize dove è supportata: inlineSize e blockSize seguono la modalità di scrittura. L’opzione box di observe() determina quale riquadro deve cambiare per attivare le notifiche; scegliere border-box non fa sì che contentRect misuri il riquadro di bordo. ECMAScript 2024 indica soltanto la versione di riferimento del linguaggio JavaScript. Entrambe le proprietà sono definite dalla specifica Resize Observer, non da ECMAScript, e la loro disponibilità dipende dall’ambiente di esecuzione.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
  const box = document.createElement('div');
  Object.assign(box.style, {
    boxSizing: 'content-box',
    width: '120px',
    height: '60px',
    padding: '10px',
    border: '2px solid black'
  });
  document.body.append(box);

  const observer = new ResizeObserver(([entry]) => {
    const { width, height } = entry.contentRect;
    console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
    observer.disconnect();
    box.remove();
  });
  observer.observe(box);
})();
</script>
</body>
</html>

Risultato

true: 120 × 60 CSS px

Salva l’esempio come file `.html` e aprilo in un browser che supporta `ResizeObserver`. Apri la console per sviluppatori e ricarica la pagina. La notifica iniziale stampa `true: 120 × 60 CSS px`: `true` conferma l’identità dell’elemento e le dimensioni escludono padding e bordi. Poi il codice interrompe l’osservazione e rimuove l’elemento.

Lezioni correlate

  • JavaScript · Lezione 32 · Intermedio · Versione: 3

Fonti