Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ResizeObserver.observe — osservare le dimensioni di un elemento

ResizeObserver.observe registra un elemento per ricevere notifiche asincrone sulle dimensioni. L’opzione box seleziona l’area osservata.

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

observer.observe(target, { box: "content-box" });

observer.observe(target, options) accetta un Element e restituisce undefined. Le notifiche raggiungono il callback dell’observer durante il rendering, non in modo sincrono.

box è "content-box" (contenuto) per impostazione predefinita; "border-box" include anche padding e bordi, mentre "device-pixel-content-box" misura il contenuto in pixel interi del dispositivo. Questa scelta controlla l’attivazione delle notifiche, non i campi disponibili nell’entry. Le trasformazioni CSS non attivano osservazioni.

Richiamare observe per lo stesso elemento con lo stesso valore di box non ha effetto in Chromium. Non dare per scontato che una chiamata del genere sostituisca la registrazione o ne reimposti lo stato delle notifiche in tutti i browser. unobserve(target) ne rimuove una, mentre disconnect() le rimuove tutte. Evita modifiche cicliche alle dimensioni nel callback. È una Web API, non una funzionalità ECMAScript; Node 24 non dimostra il supporto nei browser.

Esempi

const target = document.createElement("div");
target.style.cssText = "all: initial; display: block; width: 120px; height: 40px;";
document.body.append(target);

const observer = new ResizeObserver(([entry]) => {
  console.log(`${entry.contentRect.width} x ${entry.contentRect.height}`);
  observer.disconnect();
  target.remove();
});
observer.observe(target, { 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