WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

DOMRect.top — Koordinate der oberen Kante

`DOMRect.top` ist eine schreibgeschützte Eigenschaft, die die Koordinate der oberen Kante eines Rechtecks zurückgibt. Auch bei negativer Höhe kann das Ergebnis durch Gleitkommarundung gleich `y` sein.

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

Syntax

rect.top

DOMRect.top ist eine Instanzeigenschaft, die von DOMRectReadOnly geerbt wird. Sie gibt eine Zahl zurück, die die Koordinate der oberen Kante beschreibt, nicht die Höhe des Rechtecks.

Für endliche Werte von y und height entspricht sie Math.min(rect.y, rect.y + rect.height). Bei nichtnegativer Höhe ist der Wert gleich y; bei negativer Höhe ist er y + height.

Auch bei einem veränderbaren DOMRect bleibt top schreibgeschützt: Ändere y oder height, nicht top. Das Beispiel zeigt, wie sich das Ergebnis von 30 auf 50 ändert. Dies ist eine Web-API und kein Bestandteil der ECMAScript-Sprache; die Verfügbarkeit in Node 24 belegt nicht, dass sie auch hier verfügbar ist.

Beispiele

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

Ergebnis

30
50

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen