Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 = newHeight

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

Fonti