CKTIS / JavaScript
DOMRect: horní okraj (`top`) a výška (`height`)
`top` udává polohu horního okraje obdélníku, zatímco `height` udává jeho výšku se znaménkem. Jde o dva různé údaje, ať už obdélník vytváříš, nebo měříš prvek.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top a rect.height jsou vlastnosti instance, nikoli metody. top je svislá souřadnice horního okraje. height je výška se znaménkem, nikoli souřadnice. Obě hodnoty jsou čísla a mohou mít desetinnou část.
Pro konečné hodnoty y a height se top rovná y + height, pokud height < 0, jinak se rovná y. Záporná výška ručně vytvořeného obdélníku zůstává záporná; nepřevádí se na absolutní hodnotu. U DOMRect můžeš přiřadit hodnotu do height a při čtení top se změna zohlední. top je v obou rozhraních jen pro čtení; v DOMRectReadOnly je jen pro čtení také height.
Ve výsledku element.getBoundingClientRect() jsou obě hodnoty v pixelech CSS. top se měří od horního okraje zobrazovací oblasti a může být záporná, pokud je horní okraj obdélníku nad ním. height je nezáporná výška ohraničujícího obdélníku, která zahrnuje vnitřní odsazení (padding) a rámečky, nejen obsah. Výsledek se neaktualizuje automaticky: po posunutí zobrazení nebo změně rozvržení zavolej metodu znovu, abys získal aktuální měření. Úprava vráceného obdélníku prvek nezmění.
DOMRect je webové API, není součástí ECMAScriptu 2024. Nepředpokládej, že je k dispozici v každém běhovém prostředí JavaScriptu.
Pří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ýsledek
top=20, height=8 top=12, height=-8
Příklad nepotřebuje žádný prvek stránky. `y` zůstává `20`, ale po přiřazení `height = -8` je horní okraj na souřadnici `12`.
Související lekce
- JavaScript · Lekce 34 · Středně pokročilá · Verze: 3