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 = newHeightrect.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