CKTIS / JavaScript
DOMRect: le proprietà width e height
Leggi la larghezza e l’altezza di un rettangolo, interpreta valori frazionari e negativi e distingui le dimensioni misurate di un elemento da quelle impostate in CSS.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width e rect.height sono proprietà numeriche di istanza: indicano rispettivamente la larghezza e l’altezza, non le coordinate di posizione. Leggile senza parentesi. Sono modificabili su DOMRect e di sola lettura su DOMRectReadOnly.
Le dimensioni possono essere frazionarie. In un rettangolo che costruisci tu possono anche essere negative. Se width è negativo, left vale x + width; altrimenti vale x. Se height è negativo, top vale y + height; altrimenti vale y. Il segno negativo cambia la direzione a partire da (x, y), non la dimensione in valore assoluto.
element.getBoundingClientRect() restituisce il rettangolo che racchiude i riquadri di bordo non vuoti dell’elemento, compresi lo spazio interno (padding) e i bordi, ma non i margini. Se ci sono riquadri non vuoti, quelli vuoti vengono ignorati. Se tutti i riquadri sono vuoti, il metodo restituisce un rettangolo con larghezza e altezza pari a zero, posizionato all’origine del primo riquadro. Le dimensioni sono espresse in pixel CSS e tengono conto delle trasformazioni CSS, quindi non coincidono necessariamente con i valori CSS width e height dell’elemento. Modificare l’oggetto restituito non modifica l’elemento. Richiama il metodo per ottenere una nuova misurazione.
DOMRect è un’API Web, non fa parte di ECMAScript 2024. La disponibilità dipende dall’ambiente di esecuzione.
Esempi
{
const x = 10, y = 20, width = -30.5, height = 12.25;
// Without native DOMRect, model only the geometry used in this example.
const rect = typeof globalThis.DOMRect === "function"
? new globalThis.DOMRect(x, y, width, height)
: {
x, y, width, height,
get left() {
return this.width < 0 ? this.x + this.width : this.x;
},
};
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
rect.width = 30.5;
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}Risultato
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Esegui il codice nella console di un browser per usare `DOMRect` nativo. In Node.js senza `DOMRect`, l’esempio usa un modello geometrico semplificato. Cambiando il segno di `width`, `left` passa da `-20.5` a `10`; `height` non cambia.
Lezioni correlate
- JavaScript · Lezione 35 · Intermedio · Versione: 3