Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.getBoundingClientRect(): il rettangolo di delimitazione di un elemento

Element.getBoundingClientRect() restituisce un DOMRect che descrive la posizione e le dimensioni di un elemento rispetto alla finestra di visualizzazione. La misurazione include padding, bordi e trasformazioni CSS; il risultato è un’istantanea.

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 rect = element.getBoundingClientRect();

Element.getBoundingClientRect è un metodo della Web API, chiamato senza argomenti come element.getBoundingClientRect(). Restituisce un DOMRect: x, y, width, height e i bordi top, right, bottom, left. Le coordinate sono relative alla finestra di visualizzazione e sono espresse in pixel CSS; possono essere frazionarie.

Per un normale elemento CSS, la misurazione include padding e bordi, ma non i margini. Tiene conto delle trasformazioni applicate all’elemento e ai suoi antenati. Una rotazione produce un rettangolo di delimitazione allineato agli assi, non la forma ruotata stessa. getClientRects() restituisce i rettangoli dei singoli frammenti. Se l’elenco non è vuoto e ogni rettangolo ha larghezza zero o altezza zero, getBoundingClientRect() restituisce il primo rettangolo dell’elenco. Negli altri casi in cui l’elenco non è vuoto, restituisce il rettangolo più piccolo che racchiude tutti i rettangoli dell’elenco, tranne quelli la cui larghezza e altezza sono entrambe pari a zero.

Il risultato non si aggiorna automaticamente: esegui una nuova misurazione dopo modifiche al layout o dopo lo scorrimento. Se manca una casella di layout, ad esempio con display: none, posizione e dimensioni sono zero. Si tratta di geometria, non di un controllo della visibilità o dell’occlusione.

L’esempio crea un elemento, ne legge le misure e poi lo rimuove. width è 124 e height è 64, perché padding e bordi si aggiungono alle dimensioni del contenuto.

Esempi

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
  document.body.append(box);
  try {
    const rect = box.getBoundingClientRect();
    console.log(JSON.stringify({
      x: rect.x,
      y: rect.y,
      width: rect.width,
      height: rect.height
    }));
  } finally {
    box.remove();
  }
})();

Risultato

{"x":20,"y":30,"width":124,"height":64}

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