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 Numberelement.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