Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMRect: gornji rub (`top`) i visina (`height`)

`top` govori gdje je gornji rub pravokutnika, a `height` daje njegovu visinu s predznakom. To su dva različita podatka, bilo da stvaraš pravokutnik ili mjeriš element.

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

Sintaksa

rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()

rect.top i rect.height svojstva su instance, a ne metode. top je okomita koordinata gornjeg ruba. height je visina s predznakom, a ne koordinata. Obje su vrijednosti brojevi i mogu imati decimalni dio.

Za konačne vrijednosti y i height, top je jednak y + height ako vrijedi height < 0, a inače je jednak y. Negativna visina ručno stvorenog pravokutnika ostaje negativna; ne pretvara se u apsolutnu vrijednost. U DOMRect možeš dodijeliti vrijednost svojstvu height, a očitana vrijednost top odražava promjenu. top je samo za čitanje u oba sučelja; u DOMRectReadOnly i height je samo za čitanje.

U rezultatu poziva element.getBoundingClientRect() obje su vrijednosti izražene u CSS pikselima. top se mjeri u odnosu na gornji rub vidljivog područja i može biti negativan ako je gornji rub pravokutnika iznad njega. height je nenegativna visina obuhvatnog pravokutnika i uključuje unutarnji razmak (padding) i obrube, a ne samo sadržaj. Rezultat se ne ažurira automatski: nakon pomicanja prikaza ili promjene rasporeda ponovno pozovi metodu za novo mjerenje. Izmjena vraćenog pravokutnika ne mijenja element.

DOMRect je web API i nije dio ECMAScripta 2024. Nemoj pretpostaviti da je dostupan u svakom okruženju za izvođenje JavaScripta.

Primjeri

{
  const y = 20;
  const height = 8;

  // Without DOMRect, model only top and signed height for finite values.
  const rect = typeof DOMRect === "function"
    ? new DOMRect(0, y, 10, height)
    : {
        y,
        height,
        get top() {
          return this.height < 0 ? this.y + this.height : this.y;
        },
      };

  console.log(`top=${rect.top}, height=${rect.height}`);

  rect.height = -8;
  console.log(`top=${rect.top}, height=${rect.height}`);
}

Rezultat

top=20, height=8
top=12, height=-8

Primjer ne zahtijeva nijedan element stranice. `y` ostaje `20`, ali nakon dodjele `height = -8` gornji je rub na koordinati `12`.

Povezane lekcije

  • JavaScript · Lekcija 34 · Srednje · Verzija: 3

Izvori