Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DOMRect.width — šírka obdĺžnika

DOMRect.width je zapisovateľná vlastnosť inštancie, ktorá opisuje šírku obdĺžnika. Obsahuje číslo s pohyblivou rádovou čiarkou a povoľuje záporné hodnoty. Nezamieňajte si ju s vlastnosťou DOMRectReadOnly.width, ktorá je iba na čítanie.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

rect.width
rect.width = value

DOMRect.width opisuje šírku obdĺžnika reprezentovaného objektom DOMRect. Je to vlastnosť inštancie: čítajte ju pomocou rect.width a zmeňte ju pomocou rect.width = value. Jej typ vo Web IDL je unrestricted double, ktorý JavaScript reprezentuje ako number. Hodnota nemusí byť celočíselná ani kladná; tento typ povoľuje aj NaN, Infinity a -Infinity.

Konštruktor new DOMRect(x, y, width, height) prijíma šírku ako tretí argument. Záporná šírka sa automaticky nezmení na kladnú hodnotu. Ak sú x a width konečné a width má zápornú hodnotu, left je rovné x + width a right je rovné x. Pri nekonečných hodnotách toto zjednodušené pravidlo neplatí vždy: pri x = Infinity a width = -Infinity je x + width rovné NaN, takže výpočet maxima pre right vráti NaN, nie x.

V presnej aritmetike by sa pri konečných hodnotách x a width a zápornej hodnote width rozdiel right - left rovnal absolútnej hodnote width, ale zaokrúhľovanie pri výpočtoch s pohyblivou rádovou čiarkou v JavaScripte môže výsledok zmeniť. Napríklad pri x = 1e20 a width = -8 sa x + width zaokrúhli na x, takže right - left je 0, nie 8.

DOMRect dedí z DOMRectReadOnly, ale umožňuje zapisovať do width. To, čo obdĺžnik predstavuje, závisí od API, ktoré ho vrátilo; samotná vlastnosť neurčuje druh meranej oblasti.

Ide o funkciu Web API opísanú v Geometry Interfaces Module Level 1, nie o funkciu konkrétnej edície ECMAScriptu. MDN ju označuje za široko dostupnú v prehliadačoch od januára 2020, a to aj vo Web Workers. Príklad používa výslovne zadané súradnice, takže nezávisí od rozloženia stránky.

Príklady

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);

Výsledok

30.5
-8
2 10

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje