CKTIS / JavaScript
DOMRect.width — szerokość prostokąta
DOMRect.width to zapisywalna właściwość instancji opisująca szerokość prostokąta. Przechowuje liczbę zmiennoprzecinkową i dopuszcza wartości ujemne. Nie należy jej mylić z niezapisywalną właściwością DOMRectReadOnly.width.
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.width
rect.width = valueDOMRect.width opisuje szerokość prostokąta reprezentowanego przez obiekt DOMRect. To właściwość instancji: odczytujesz ją jako rect.width, a zmieniasz przez rect.width = value. Wartość ma typ Web IDL unrestricted double, reprezentowany w JavaScript jako number. Nie musi być całkowita ani dodatnia; typ ten dopuszcza również NaN, Infinity i -Infinity.
Konstruktor new DOMRect(x, y, width, height) przyjmuje szerokość jako trzeci argument. Ujemna szerokość nie jest automatycznie zamieniana na dodatnią. Gdy x i width są skończone, a width jest ujemna, left wynosi x + width, a right wynosi x. Przy wartościach nieskończonych nie można zakładać takiego wyniku: dla x = Infinity i width = -Infinity suma x + width daje NaN, więc obliczenie maksimum na potrzeby right zwraca NaN, a nie x.
W arytmetyce dokładnej dla skończonych x i width oraz ujemnej width różnica right - left jest równa wartości bezwzględnej width, ale w JavaScript zaokrąglenia zmiennoprzecinkowe mogą zmienić wynik. Na przykład dla x = 1e20 i width = -8 suma x + width zaokrągla się do x, więc right - left wynosi 0, a nie 8.
DOMRect dziedziczy po DOMRectReadOnly, lecz umożliwia zapis do width. Znaczenie reprezentowanego prostokąta zależy od API, które go zwróciło; sama właściwość nie określa rodzaju mierzonego obszaru.
To funkcja Web API opisana w Geometry Interfaces Module Level 1, a nie funkcja konkretnej edycji ECMAScript. MDN oznacza ją jako szeroko dostępną w przeglądarkach od stycznia 2020 r., również w Web Workers. Przykład używa jawnych współrzędnych, więc nie zależy od układu strony.
Przykłady
const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);
rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);Wynik
30.5 -8 2 10
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.