Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Rettangolo delimitatore e scostamenti dell’area client

Misura la posizione e le dimensioni di un elemento rispetto alla viewport e distingui questi valori dagli scostamenti a sinistra e in alto dell’area client.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

element.getBoundingClientRect() // DOMRect
 element.clientLeft // integer Number
 element.clientTop // integer Number

element.getBoundingClientRect() è un metodo di Element senza argomenti. Restituisce un DOMRect calcolato a partire dai rettangoli che getClientRects() fornisce per i riquadri di bordo dopo l’applicazione delle trasformazioni. Se l’elenco è vuoto, tutti i valori sono zero. Se ciascun rettangolo dell’elenco ha larghezza o altezza pari a zero, il metodo restituisce il primo rettangolo dell’elenco. Altrimenti restituisce il più piccolo rettangolo allineato agli assi che racchiude i rettangoli con larghezza o altezza diversa da zero. Include il padding e i bordi, non i margini. left e top sono coordinate relative all’angolo superiore sinistro della viewport; width e height sono dimensioni. I valori sono espressi in pixel CSS e possono essere frazionari.

element.clientLeft ed element.clientTop sono proprietà di sola lettura, non metodi. Restituiscono scostamenti interi in pixel CSS senza tenere conto delle trasformazioni: lo spessore del bordo sinistro e superiore, rispettivamente, più lo spazio occupato da un’eventuale barra di scorrimento sullo stesso lato. Una barra verticale può trovarsi a sinistra, ad esempio in un layout da destra a sinistra. Il padding e il margine non sono inclusi. Entrambe le proprietà valgono zero per un riquadro inline o in assenza di un riquadro CSS.

Il DOMRect è un’istantanea. Se ti servono coordinate aggiornate, ripeti la misura dopo lo scorrimento o una modifica del layout. Per ottenere coordinate relative al documento, aggiungi window.scrollX a left e window.scrollY a top. Non usare clientLeft e clientTop come coordinate della viewport né come metodo generale di conversione delle coordinate dopo una trasformazione. Queste API fanno parte della piattaforma web (CSSOM View), non di ECMAScript 2024; la disponibilità dipende dall’ambiente di esecuzione.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element geometry</title>
</head>
<body>
<script>
(() => {
  // Use a 1:1 ratio so the borders need no device-pixel rounding.
  if (window.devicePixelRatio !== 1) {
    throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
  }

  const box = document.createElement('div');
  box.style.cssText = `
    position: fixed; left: 20px; top: 30px;
    box-sizing: border-box; width: 80px; height: 40px;
    border: solid black; border-width: 5px 2px 2px 3px;
    overflow: hidden; transform-origin: top left; transform: scale(2);
  `;
  document.body.append(box);
  try {
    const { left, top, width, height } = box.getBoundingClientRect();
    console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
    console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Risultato

rect: 20, 30, 160, 80
client: 3, 5

Apri il documento HTML in un browser con lo zoom della pagina al 100% e `devicePixelRatio` pari a `1`. Leggi il risultato nella console del browser. Il ridimensionamento raddoppia le dimensioni del rettangolo senza spostarne l’angolo superiore sinistro; gli scostamenti restano `3` e `5`.

Lezioni correlate

  • JavaScript · Lezione 35 · Avanzato · Versione: 4

Fonti