Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMRect: właściwości width i height

Odczytuj szerokość i wysokość prostokąta, interpretuj wartości ułamkowe i ujemne oraz odróżniaj wynik pomiaru elementu od jego rozmiaru ustawionego w CSS.

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

Składnia

rect.width
rect.height
rect.width = newWidth
rect.height = newHeight

rect.width i rect.height to liczbowe właściwości instancji: oznaczają odpowiednio szerokość i wysokość, a nie współrzędne położenia. Odczytuj je bez nawiasów. W obiekcie DOMRect można je również zmieniać; w DOMRectReadOnly są tylko do odczytu.

Wymiary mogą być ułamkowe, a w prostokącie utworzonym samodzielnie mogą też być ujemne. Dla ujemnego width lewa krawędź left wynosi x + width; w przeciwnym razie wynosi x. Analogicznie dla ujemnego height górna krawędź top wynosi y + height; w przeciwnym razie wynosi y. Ujemny znak zmienia kierunek od punktu (x, y), a nie rozmiar bezwzględny.

element.getBoundingClientRect() zwraca prostokąt obejmujący niepuste pola obramowania elementu, czyli obszary z wewnętrznymi odstępami (padding) i obramowaniem, ale bez marginesów. Jeśli istnieją niepuste pola, metoda pomija puste. Jeśli wszystkie pola są puste, zwraca prostokąt o zerowej szerokości i wysokości w punkcie początkowym pierwszego pola. Jego wymiary są podane w pikselach CSS i uwzględniają transformacje CSS, więc nie muszą odpowiadać wartościom width i height ustawionym w CSS. Zapis do zwróconego obiektu nie zmienia elementu. Aby uzyskać aktualny pomiar, wywołaj metodę ponownie.

DOMRect to API platformy webowej, a nie część ECMAScript 2024. Jego dostępność zależy od środowiska uruchomieniowego.

Przykłady

{
  const x = 10, y = 20, width = -30.5, height = 12.25;
  // Without native DOMRect, model only the geometry used in this example.
  const rect = typeof globalThis.DOMRect === "function"
    ? new globalThis.DOMRect(x, y, width, height)
    : {
        x, y, width, height,
        get left() {
          return this.width < 0 ? this.x + this.width : this.x;
        },
      };
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
  rect.width = 30.5;
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}

Wynik

width=-30.5, height=12.25, left=-20.5
width=30.5, height=12.25, left=10

Uruchom kod w konsoli przeglądarki, aby użyć wbudowanego `DOMRect`. W Node.js bez `DOMRect` przykład korzysta z uproszczonego modelu geometrycznego. Zmiana znaku `width` przesuwa `left` z `-20.5` na `10`; `height` się nie zmienia.

Powiązane lekcje

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

Źródła