Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMRect: górna krawędź (`top`) i wysokość (`height`)

`top` mówi, gdzie znajduje się górna krawędź prostokąta, a `height` określa jego wysokość ze znakiem. Te właściwości odpowiadają na różne pytania, niezależnie od tego, czy tworzysz prostokąt, czy mierzysz element.

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

Składnia

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

rect.top i rect.height to właściwości instancji, a nie metody. top jest współrzędną pionową górnej krawędzi. height jest wysokością ze znakiem, a nie współrzędną. Obie wartości są liczbami i mogą mieć część ułamkową.

Dla skończonych wartości y i height właściwość top ma wartość y + height, gdy height < 0, a w przeciwnym razie y. Ujemna wysokość w prostokącie utworzonym ręcznie pozostaje ujemna: nie jest zamieniana na wartość bezwzględną. W DOMRect można przypisać nową wartość do height, a odczyt top uwzględni tę zmianę. top jest tylko do odczytu w obu interfejsach, a height jest tylko do odczytu w DOMRectReadOnly.

W wyniku element.getBoundingClientRect() obie wartości są podane w pikselach CSS. top jest mierzony względem górnej krawędzi obszaru widoku i może być ujemny, gdy górna krawędź prostokąta leży powyżej niej. height to nieujemna wysokość prostokąta ograniczającego, która uwzględnia wewnętrzny odstęp (padding) i obramowanie, a nie tylko treść. Wynik nie aktualizuje się automatycznie: po przewinięciu lub zmianie układu wywołaj metodę ponownie, aby uzyskać aktualny pomiar. Zmiana właściwości zwróconego prostokąta nie zmienia elementu.

DOMRect należy do API platformy webowej, a nie do ECMAScript 2024. Nie zakładaj, że jest dostępny w każdym środowisku JavaScript.

Przykłady

{
  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}`);
}

Wynik

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

Przykład nie wymaga elementu strony. `y` pozostaje równe `20`, ale po przypisaniu `height = -8` górna krawędź ma współrzędną `12`.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Średniozaawansowany · Wersja: 3

Źródła