Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMRect.width — šířka obdélníku

DOMRect.width je zapisovatelná vlastnost instance, která popisuje šířku obdélníku. Obsahuje číslo s plovoucí desetinnou čárkou a umožňuje záporné hodnoty. Nezaměňujte ji s vlastností DOMRectReadOnly.width, která je pouze pro čtení.

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

Syntaxe

rect.width
rect.width = value

DOMRect.width popisuje šířku obdélníku reprezentovaného objektem DOMRect. Jde o vlastnost instance: čtěte ji pomocí rect.width a změňte ji pomocí rect.width = value. Její typ v rámci Web IDL je unrestricted double, který JavaScript reprezentuje jako number. Hodnota nemusí být celočíselná ani kladná; tento typ připouští i NaN, Infinity a -Infinity.

Konstruktor new DOMRect(x, y, width, height) přijímá šířku jako třetí argument. Záporná šířka se automaticky nepřevádí na kladnou hodnotu. Jsou-li x a width konečné a width je záporné, left je rovno x + width a right je rovno x. Pro nekonečné hodnoty toto zjednodušené pravidlo neplatí vždy: při x = Infinity a width = -Infinity je x + width rovno NaN, takže výpočet maxima pro right vrátí NaN, nikoli x.

V přesné aritmetice by se při konečných hodnotách x a width a záporné hodnotě width rozdíl right - left rovnal absolutní hodnotě width, ale zaokrouhlování při výpočtech s plovoucí desetinnou čárkou v JavaScriptu může výsledek změnit. Například pro x = 1e20 a width = -8 se x + width zaokrouhlí na x, takže right - left je 0, nikoli 8.

DOMRect dědí z DOMRectReadOnly, ale umožňuje zápis do width. Co obdélník představuje, závisí na API, které jej vrátilo; samotná vlastnost neurčuje druh měřené oblasti.

Jde o funkci Web API popsanou v Geometry Interfaces Module Level 1, nikoli o funkci konkrétní edice ECMAScriptu. MDN ji označuje za široce dostupnou v prohlížečích od ledna 2020, včetně Web Workers. Příklad používá výslovně zadané souřadnice, takže nezávisí na rozvržení stránky.

Pří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ýsledek

30.5
-8
2 10

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje