Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMRect: bordo superiore (`top`) e altezza (`height`)

`top` indica dove si trova il bordo superiore del rettangolo, mentre `height` indica l’altezza con segno. Le due proprietà forniscono informazioni diverse, sia quando crei un rettangolo sia quando misuri un elemento.

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

Sintassi

rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()

rect.top e rect.height sono proprietà di istanza, non metodi. top è la coordinata verticale del bordo superiore. height è l’altezza con segno, non una coordinata. Entrambi i valori sono numeri e possono avere una parte frazionaria.

Per valori finiti di y e height, top vale y + height se height < 0, altrimenti vale y. Un’altezza negativa in un rettangolo costruito manualmente rimane negativa: non viene convertita nel suo valore assoluto. In un DOMRect puoi assegnare un valore a height; quando leggi top, il valore tiene conto della modifica. top è di sola lettura in entrambe le interfacce; height è di sola lettura in DOMRectReadOnly.

Nel risultato di element.getBoundingClientRect(), entrambi i valori sono in pixel CSS. top è relativo al bordo superiore dell’area di visualizzazione e può essere negativo se il bordo superiore del rettangolo è più in alto. height è l’altezza non negativa del rettangolo delimitatore e tiene conto dello spazio interno (padding) e dei bordi, non solo del contenuto. Il risultato non si aggiorna automaticamente: chiama di nuovo il metodo dopo uno scorrimento o una modifica del layout per ottenere una nuova misurazione. Modificare il rettangolo restituito non cambia l’elemento.

DOMRect è un’API Web, non fa parte di ECMAScript 2024. Non dare per scontato che sia disponibile in ogni ambiente di esecuzione JavaScript.

Esempi

{
  const y = 20;
  const height = 8;

  // Without DOMRect, model only top and signed height for finite values.
  const rect = typeof DOMRect === "function"
    ? new DOMRect(0, y, 10, height)
    : {
        y,
        height,
        get top() {
          return this.height < 0 ? this.y + this.height : this.y;
        },
      };

  console.log(`top=${rect.top}, height=${rect.height}`);

  rect.height = -8;
  console.log(`top=${rect.top}, height=${rect.height}`);
}

Risultato

top=20, height=8
top=12, height=-8

L’esempio non richiede elementi della pagina. `y` rimane `20`, ma dopo l’assegnazione `height = -8` il bordo superiore si trova a `12`.

Lezioni correlate

  • JavaScript · Lezione 34 · Intermedio · Versione: 3

Fonti