CKTIS / JavaScript
Misurare l’altezza del rettangolo di delimitazione di un elemento
`getBoundingClientRect()` misura la geometria di un elemento rispetto al viewport. `DOMRect.height` restituisce l’altezza del rettangolo in pixel CSS.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
const rect = element.getBoundingClientRect();
const height = rect.height;Chiama element.getBoundingClientRect() senza argomenti. Il metodo d’istanza di Element restituisce un DOMRect in base all’elenco fornito da getClientRects(). Se l’elenco è vuoto, restituisce un rettangolo con x, y, width e height tutti pari a 0. Se ciascun rettangolo dell’elenco ha larghezza o altezza pari a zero, restituisce il primo rettangolo, che può comunque avere un’altezza diversa da zero. Altrimenti restituisce il più piccolo rettangolo allineato agli assi che racchiude tutti i rettangoli con larghezza o altezza diversa da zero, compresi quelli con una sola dimensione diversa da zero. Coordinate come top e left sono relative al viewport e possono cambiare con lo scorrimento. L’altezza è una dimensione, non una coordinata.
Leggi rect.height senza parentesi. È un numero in pixel CSS e può essere frazionario. Per un semplice elemento HTML con un solo riquadro, la misura comprende il contenuto, lo spazio interno (padding) e i bordi, ma non i margini. Tiene conto delle trasformazioni CSS, quindi può differire dalla proprietà CSS height e dall’altezza intera di layout offsetHeight. Se l’elemento non genera alcun riquadro CSS, come con display: none, l’altezza è 0.
Il rettangolo è un’istantanea. Misura di nuovo dopo una modifica del layout o della trasformazione. Assegnare un valore a rect.height modifica solo l’oggetto DOMRect, non l’elemento; in DOMRectReadOnly la proprietà è di sola lettura.
È un’API web, non una funzionalità di ECMAScript 2024. La misurazione richiede un ambiente con DOM e supporto al layout. Controlla il risultato di querySelector() prima della chiamata: tentare di chiamare il metodo su null genera un TypeError, non una misura pari a zero.
Esempi
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Bounding rectangle height</title>
</head>
<body>
<script>
const box = document.createElement('div');
box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
document.body.append(box);
const before = box.getBoundingClientRect();
box.style.transform = 'scaleY(0.5)';
console.log(before.height);
console.log(box.getBoundingClientRect().height);
box.remove();
</script>
</body>
</html>Risultato
54 27
Salva l’esempio come file HTML, aprilo nel browser e controlla la console degli strumenti di sviluppo. Il rettangolo salvato indica `54`; dopo `scaleY(0.5)`, la nuova misura indica `27`.
Lezioni correlate
- JavaScript · Lezione 11 · Avanzato · Versione: 4