Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMRect.top — współrzędna górnej krawędzi

`DOMRect.top` to właściwość tylko do odczytu, która zwraca współrzędną górnej krawędzi prostokąta. Nawet przy ujemnej wysokości wynik może być równy `y` z powodu zaokrąglenia zmiennoprzecinkowego.

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

Składnia

rect.top

DOMRect.top to właściwość instancji odziedziczona z DOMRectReadOnly. Zwraca liczbę określającą współrzędną górnej krawędzi, a nie wysokość prostokąta.

Dla skończonych y i height odpowiada Math.min(rect.y, rect.y + rect.height). Przy nieujemnej wysokości wynosi y; przy ujemnej — y + height.

top jest tylko do odczytu także w modyfikowalnym DOMRect: zmieniaj y lub height, nie top. Przykład pokazuje zmianę wyniku z 30 na 50. To Web API, nie funkcja samego ECMAScript; obecność Node 24 nie dowodzi dostępności.

Przykłady

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

Wynik

30
50

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła