Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMRect.width — širina pravokutnika

DOMRect.width je zapisivo svojstvo instance koje opisuje širinu pravokutnika. Sadrži broj s pomičnim zarezom i dopušta negativne vrijednosti. Nemojte ga zamijeniti sa svojstvom DOMRectReadOnly.width koje je samo za čitanje.

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

Sintaksa

rect.width
rect.width = value

DOMRect.width opisuje širinu pravokutnika koji predstavlja objekt DOMRect. To je svojstvo instance: pročitajte ga kao rect.width, a promijenite pomoću rect.width = value. Njegov je tip u Web IDL-u unrestricted double, koji se u JavaScriptu prikazuje kao number. Vrijednost ne mora biti cijeli ni pozitivan broj; taj tip dopušta i NaN, Infinity i -Infinity.

Konstruktor new DOMRect(x, y, width, height) prima širinu kao treći argument. Negativna širina ne pretvara se automatski u pozitivnu vrijednost. Ako su x i width konačni, a width je negativan, left je x + width, a right je x. To pojednostavljeno pravilo ne vrijedi uvijek za beskonačne vrijednosti: za x = Infinity i width = -Infinity zbroj x + width daje NaN, pa izračun maksimuma za right vraća NaN, a ne x.

U točnoj aritmetici za konačne vrijednosti x i width i negativnu vrijednost width razlika right - left bila bi jednaka apsolutnoj vrijednosti width, no zaokruživanje pri računanju s pomičnim zarezom u JavaScriptu može promijeniti rezultat. Primjerice, za x = 1e20 i width = -8 zbroj x + width zaokružuje se na x, pa je right - left jednak 0, a ne 8.

DOMRect nasljeđuje od DOMRectReadOnly, ali dopušta zapisivanje u width. Što pravokutnik predstavlja ovisi o API-ju koji ga je vratio; samo svojstvo ne određuje vrstu područja koje se mjeri.

Ovo je značajka Web API-ja opisana u Geometry Interfaces Module Level 1, a ne značajka određenog izdanja ECMAScripta. MDN je označava kao široko dostupnu u preglednicima od siječnja 2020., uključujući Web Workers. Primjer koristi izričito zadane koordinate pa ne ovisi o izgledu stranice.

Primjeri

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

Rezultat

30.5
-8
2 10

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori