Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

DOMRect.width — širina pravokotnika

DOMRect.width je zapisljiva lastnost primerka, ki opisuje širino pravokotnika. Vsebuje število s plavajočo vejico in dovoljuje negativne vrednosti. Ne zamenjujte je z lastnostjo DOMRectReadOnly.width, ki je samo za branje.

Različica: 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 širino pravokotnika, ki ga predstavlja objekt DOMRect. Gre za lastnost primerka: preberete jo z rect.width in spremenite z rect.width = value. V Web IDL ima tip unrestricted double, ki je v JavaScriptu predstavljen kot number. Vrednost ni nujno celo ali pozitivno število; ta tip dovoljuje tudi NaN, Infinity in -Infinity.

Konstruktor new DOMRect(x, y, width, height) sprejme širino kot tretji argument. Negativna širina se ne pretvori samodejno v pozitivno vrednost. Če sta x in width končna in je width negativen, je left enak x + width, right pa je enak x. To poenostavljeno pravilo ne velja vedno za neskončne vrednosti: pri x = Infinity in width = -Infinity je x + width enak NaN, zato izračun maksimuma za right vrne NaN in ne x.

Pri natančnem računanju s končnima vrednostma x in width ter negativno vrednostjo width bi bil right - left enak absolutni vrednosti width, vendar lahko zaokroževanje pri računanju s plavajočo vejico v JavaScriptu spremeni rezultat. Na primer, pri x = 1e20 in width = -8 se x + width zaokroži na x, zato je right - left enak 0 in ne 8.

DOMRect deduje od DOMRectReadOnly, vendar omogoča zapisovanje v width. Kaj pravokotnik predstavlja, je odvisno od API-ja, ki ga je vrnil; sama lastnost ne določa vrste merjenega območja.

To je funkcija spletnega API-ja, opisana v Geometry Interfaces Module Level 1, in ne funkcija določene izdaje ECMAScripta. MDN jo označuje kot široko dostopno v brskalnikih od januarja 2020, tudi v Web Workers. Primer uporablja izrecno določene koordinate, zato ni odvisen od postavitve strani.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri