Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

DOMRect.top — coordenada do limite superior

`DOMRect.top` é uma propriedade só de leitura que devolve a coordenada do limite superior de um rectângulo. Mesmo com uma altura negativa, o arredondamento em vírgula flutuante pode fazer com que o resultado seja igual a `y`.

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

Sintaxe

rect.top

DOMRect.top é uma propriedade de instância herdada de DOMRectReadOnly. Devolve um número que descreve a coordenada do limite superior, não a altura do rectângulo.

Para valores finitos de y e height, corresponde a Math.min(rect.y, rect.y + rect.height). Com uma altura não negativa, é igual a y; com uma altura negativa, é y + height.

top continua a ser só de leitura mesmo num DOMRect modificável: altera y ou height, não top. O exemplo mostra o resultado a mudar de 30 para 50. Esta é uma API Web, não uma funcionalidade da linguagem ECMAScript; a presença do Node 24 não comprova a sua disponibilidade.

Exemplos

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

Resultado

30
50

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes