CKTIS / JavaScript
DOMRect: свойства width и height
Прочети ширината и височината на правоъгълник, разбери дробните и отрицателните стойности и различавай измерените размери на елемент от зададените в CSS.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width и rect.height са числови свойства на обекта: означават съответно ширина и височина, а не координати на позицията. Чети ги без скоби. В DOMRect могат да се променят, а в DOMRectReadOnly са само за четене.
Размерите могат да са дробни. При правоъгълник, който създаваш сам, могат да са и отрицателни. Ако width е отрицателна, left е x + width; иначе е x. Ако height е отрицателна, top е y + height; иначе е y. Отрицателният знак променя посоката от точката (x, y), а не абсолютната големина на размера.
element.getBoundingClientRect() връща правоъгълника, който обхваща непразните кутии на елемента до външния ръб на рамките им, включително вътрешните отстъпи (padding) и рамките, но без външните отстъпи (margin). Ако има непразни кутии, празните се пропускат. Ако всички кутии са празни, методът връща правоъгълник с нулева ширина и височина в началната точка на първата кутия. Размерите са в CSS пиксели и отчитат CSS трансформациите, затова не е задължително да съвпадат със стойностите на width и height на елемента в CSS. Промяната на върнатия обект не променя елемента. Извикай метода отново за ново измерване.
DOMRect е уеб API, а не част от ECMAScript 2024. Достъпността му зависи от средата за изпълнение.
Примери
{
const x = 10, y = 20, width = -30.5, height = 12.25;
// Without native DOMRect, model only the geometry used in this example.
const rect = typeof globalThis.DOMRect === "function"
? new globalThis.DOMRect(x, y, width, height)
: {
x, y, width, height,
get left() {
return this.width < 0 ? this.x + this.width : this.x;
},
};
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
rect.width = 30.5;
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}Резултат
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Изпълни кода в конзолата на браузър, за да използваш вградения `DOMRect`. В Node.js без `DOMRect` примерът използва опростен геометричен модел. Промяната на знака на `width` премества `left` от `-20.5` на `10`; `height` остава непроменена.
Свързани уроци
- JavaScript · Урок 35 · Средно · Версия: 3