Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMRect.top — coordinata del bordo superiore

`DOMRect.top` è una proprietà di sola lettura che restituisce la coordinata del bordo superiore di un rettangolo. Anche con un’altezza negativa, l’arrotondamento in virgola mobile può rendere il risultato uguale a `y`.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

rect.top

DOMRect.top è una proprietà di istanza ereditata da DOMRectReadOnly. Restituisce un numero che descrive la coordinata del bordo superiore, non l’altezza del rettangolo.

Per valori finiti di y e height, corrisponde a Math.min(rect.y, rect.y + rect.height). Con un’altezza non negativa è uguale a y; con un’altezza negativa è y + height.

top resta di sola lettura anche in un DOMRect modificabile: modifica y o height, non top. L’esempio mostra il risultato che passa da 30 a 50. Questa è una Web API, non una funzionalità del linguaggio ECMAScript; la presenza di Node 24 non ne dimostra la disponibilità.

Esempi

const rect = new DOMRect(10, 50, 80, -20);
console.log(rect.top);
rect.height = 20;
console.log(rect.top);

Risultato

30
50

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti