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