CKTIS / JavaScript
DOMRect: zgornji rob (`top`) in višina (`height`)
`top` pove, kje je zgornji rob pravokotnika, `height` pa poda njegovo višino s predznakom. Lastnosti podajata različna podatka, ne glede na to, ali pravokotnik ustvariš ali izmeriš element.
Različica: 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 in rect.height sta lastnosti primerka, ne metodi. top je navpična koordinata zgornjega roba. height je višina s predznakom, ne koordinata. Obe vrednosti sta števili in imata lahko decimalni del.
Pri končnih vrednostih y in height je top enak y + height, če velja height < 0, sicer pa je enak y. Negativna višina ročno ustvarjenega pravokotnika ostane negativna; ne pretvori se v absolutno vrednost. Pri DOMRect lahko lastnosti height dodeliš vrednost; pri branju top se nova vrednost upošteva. top je v obeh vmesnikih samo za branje; v DOMRectReadOnly je samo za branje tudi height.
V rezultatu element.getBoundingClientRect() sta obe vrednosti izraženi v slikovnih pikah CSS. top se meri glede na zgornji rob vidnega polja in je lahko negativen, če je zgornji rob pravokotnika nad njim. height je nenegativna višina omejevalnega pravokotnika, ki zajema notranji odmik (padding) in obrobe, ne le vsebine. Rezultat se ne posodobi samodejno: po pomikanju ali spremembi postavitve znova pokliči metodo za novo meritev. Spreminjanje vrnjenega pravokotnika ne spremeni elementa.
DOMRect je spletni API in ni del ECMAScripta 2024. Ne predpostavljaj, da je na voljo v vsakem izvajalnem okolju JavaScript.
Primeri
{
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
Primer ne potrebuje nobenega elementa strani. `y` ostane `20`, vendar je po dodelitvi `height = -8` zgornji rob na koordinati `12`.
Povezane lekcije
- JavaScript · Lekcija 34 · Srednja · Različica: 3