CKTIS / JavaScript
DOMRect: горен ръб (`top`) и височина (`height`)
`top` показва къде е горният ръб на правоъгълника, а `height` дава височината му със знак. Двете свойства дават различна информация, независимо дали създаваш правоъгълник, или измерваш елемент.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top и rect.height са свойства на екземпляра, а не методи. top е вертикалната координата на горния ръб. height е височината със знак, а не координата. И двете стойности са числа и могат да имат дробна част.
При крайни стойности на y и height, top е равно на y + height, ако height < 0, и на y в противен случай. Отрицателната височина на ръчно създаден правоъгълник остава отрицателна: тя не се преобразува в абсолютна стойност. В DOMRect можеш да зададеш стойност на height, а при прочитане на top промяната се отчита. top е само за четене и в двата интерфейса; в DOMRectReadOnly и height е само за четене.
В резултата от element.getBoundingClientRect() и двете стойности са в CSS пиксели. top се измерва спрямо горния край на видимата област и може да е отрицателно, ако горният ръб на правоъгълника е над него. height е неотрицателната височина на обхващащия правоъгълник, която отчита вътрешния отстъп (padding) и рамките, а не само съдържанието. Резултатът не се обновява автоматично: след превъртане или промяна в оформлението извикай метода отново за актуално измерване. Промяната на върнатия правоъгълник не променя елемента.
DOMRect е уеб API, а не част от ECMAScript 2024. Не приемай, че е наличен във всяка среда за изпълнение на JavaScript.
Примери
{
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}`);
}Резултат
top=20, height=8 top=12, height=-8
Примерът не изисква елемент от страницата. `y` остава `20`, но след присвояването `height = -8` горният ръб е на координата `12`.
Свързани уроци
- JavaScript · Урок 34 · Средно · Версия: 3