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

CKTIS / JavaScript

DOMRect: lastnosti width in height

Preberi širino in višino pravokotnika, razloži ulomljene in negativne vrednosti ter loči izmerjene mere elementa od njegovih mer v CSS.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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

rect.width in rect.height sta številski lastnosti primerka: podajata širino oziroma višino, ne koordinat položaja. Prebereš ju brez oklepajev. Na objektu DOMRect ju lahko spreminjaš, na DOMRectReadOnly pa sta samo za branje.

Mere imajo lahko decimalna mesta. Pri pravokotniku, ki ga ustvariš sam, so lahko tudi negativne. Če je width negativen, je left enak x + width; sicer je enak x. Če je height negativen, je top enak y + height; sicer je enak y. Negativen predznak spremeni smer od točke (x, y), ne absolutne velikosti.

element.getBoundingClientRect() vrne pravokotnik, ki zajema neprazne okvirje elementa do zunanjega roba obrobe, torej z notranjimi odmiki (padding) in obrobami, vendar brez zunanjih odmikov (margin). Če obstajajo neprazni okvirji, se prazni prezrejo. Če so vsi okvirji prazni, metoda vrne pravokotnik z ničelno širino in višino v izhodišču prvega okvirja. Mere so v slikovnih pikah CSS in upoštevajo transformacije CSS, zato se ne ujemajo nujno z vrednostma width in height elementa v CSS. Sprememba vrnjenega objekta ne spremeni elementa. Za novo meritev znova pokliči metodo.

DOMRect je spletni API in ni del ECMAScripta 2024. Njegova razpoložljivost je odvisna od izvajalnega okolja.

Primeri

{
  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

Zaženi kodo v konzoli brskalnika, da uporabiš vgrajeni `DOMRect`. V okolju Node.js brez `DOMRect` primer uporablja poenostavljen geometrijski model. Ko spremeniš predznak `width`, se `left` premakne z `-20.5` na `10`; `height` se ne spremeni.

Povezane lekcije

  • JavaScript · Lekcija 35 · Srednja · Različica: 3

Viri