Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMRect: svojstva width i height

Očitaj širinu i visinu pravokutnika, protumači razlomljene i negativne vrijednosti te razlikuj izmjerene dimenzije elementa od njegovih dimenzija u CSS-u.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

rect.width
rect.height
rect.width = newWidth
rect.height = newHeight

rect.width i rect.height brojčana su svojstva instance: označavaju širinu odnosno visinu, a ne koordinate položaja. Čitaj ih bez zagrada. Na objektu DOMRect možeš ih mijenjati, a na objektu DOMRectReadOnly dostupna su samo za čitanje.

Dimenzije ne moraju biti cijeli brojevi. U pravokutniku koji samostalno stvoriš mogu biti i negativne. Ako je width negativan, left iznosi x + width; inače iznosi x. Ako je height negativan, top iznosi y + height; inače iznosi y. Negativan predznak mijenja smjer od točke (x, y), a ne apsolutnu veličinu dimenzije.

element.getBoundingClientRect() vraća pravokutnik koji obuhvaća neprazne okvire elementa do vanjskog ruba obruba, uključujući unutarnji razmak (padding) i obrube, ali ne i margine. Ako postoje neprazni okviri, prazni se zanemaruju. Ako su svi okviri prazni, metoda vraća pravokutnik nulte širine i visine u ishodištu prvog okvira. Dimenzije su izražene u CSS pikselima i uzimaju u obzir CSS transformacije, pa se ne moraju podudarati s vrijednostima width i height elementa u CSS-u. Izmjena vraćenog objekta ne mijenja element. Ponovno pozovi metodu za novo mjerenje.

DOMRect je web API, a ne dio ECMAScripta 2024. Dostupnost ovisi o izvršnom okruženju.

Primjeri

{
  const x = 10, y = 20, width = -30.5, height = 12.25;
  // Without native DOMRect, model only the geometry used in this example.
  const rect = typeof globalThis.DOMRect === "function"
    ? new globalThis.DOMRect(x, y, width, height)
    : {
        x, y, width, height,
        get left() {
          return this.width < 0 ? this.x + this.width : this.x;
        },
      };
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
  rect.width = 30.5;
  console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}

Rezultat

width=-30.5, height=12.25, left=-20.5
width=30.5, height=12.25, left=10

Pokreni kôd u konzoli preglednika da upotrijebiš ugrađeni `DOMRect`. U okruženju Node.js bez `DOMRect` primjer koristi pojednostavljeni geometrijski model. Promjena predznaka svojstva `width` pomiče `left` s `-20.5` na `10`; `height` ostaje isti.

Povezane lekcije

  • JavaScript · Lekcija 35 · Srednje · Verzija: 3

Izvori