Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 = value

DOMRect.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.

Źródła