CKTIS / JavaScript
DOMRect: horný okraj (`top`) a výška (`height`)
`top` určuje polohu horného okraja obdĺžnika a `height` udáva jeho výšku so znamienkom. Sú to dva rôzne údaje bez ohľadu na to, či vytváraš obdĺžnik alebo meriaš prvok.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top a rect.height sú vlastnosti inštancie, nie metódy. top je zvislá súradnica horného okraja. height je výška so znamienkom, nie súradnica. Obe hodnoty sú čísla a môžu mať desatinnú časť.
Pre konečné hodnoty y a height sa top rovná y + height, ak height < 0, inak sa rovná y. Záporná výška ručne vytvoreného obdĺžnika zostáva záporná; neprevedie sa na absolútnu hodnotu. V DOMRect môžeš priradiť hodnotu do height a pri čítaní top sa zmena zohľadní. top je v oboch rozhraniach len na čítanie; v DOMRectReadOnly je len na čítanie aj height.
Vo výsledku element.getBoundingClientRect() sú obe hodnoty v pixeloch CSS. top sa meria od horného okraja zobrazovacej oblasti a môže byť záporná, ak je horný okraj obdĺžnika nad ním. height je nezáporná výška ohraničujúceho obdĺžnika, ktorá zahŕňa vnútorné odsadenie (padding) aj orámovanie, nielen obsah. Výsledok sa neaktualizuje automaticky: po posunutí zobrazenia alebo zmene rozloženia zavolaj metódu znova a získaš aktuálne meranie. Úprava vráteného obdĺžnika prvok nezmení.
DOMRect je webové API, nie súčasť ECMAScriptu 2024. Nepredpokladaj, že je dostupné v každom vykonávacom prostredí JavaScriptu.
Príklady
{
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}`);
}Výsledok
top=20, height=8 top=12, height=-8
Príklad nepotrebuje žiadny prvok stránky. `y` zostáva `20`, ale po priradení `height = -8` je horný okraj na súradnici `12`.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3