CKTIS / JavaScript
Element.getBoundingClientRect(): ограничаващият правоъгълник на елемент
Element.getBoundingClientRect() връща DOMRect, който описва позицията и размера на елемент спрямо видимата област. Измерването включва вътрешните отстъпи, рамките и CSS трансформациите; резултатът е моментна снимка.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const rect = element.getBoundingClientRect();Element.getBoundingClientRect е метод от Web API, който се извиква без аргументи като element.getBoundingClientRect(). Връща DOMRect: x, y, width, height и ръбовете top, right, bottom, left. Координатите са спрямо видимата област и са в CSS пиксели; може да са дробни.
При обикновен CSS елемент измерването включва вътрешните отстъпи и рамките, но не и външните отстъпи. Отчитат се трансформациите на елемента и неговите предци. Завъртането създава ограничаващ правоъгълник, подравнен по осите, а не самата завъртяна форма. getClientRects() връща правоъгълниците на отделните фрагменти. Ако списъкът не е празен и всеки правоъгълник има нулева ширина или нулева височина, getBoundingClientRect() връща първия правоъгълник от списъка. В останалите случаи, когато списъкът не е празен, методът връща най-малкия правоъгълник, който обхваща всички правоъгълници от списъка, с изключение на тези, при които и ширината, и височината са нула.
Резултатът не се актуализира автоматично: направете ново измерване след промени в оформлението или превъртане. Ако няма кутия за оформление, например при display: none, позицията и размерите са нулеви. Това описва геометрия, а не проверява видимост или закриване.
Примерът създава елемент, прочита измерването му и го премахва. width е 124, а height е 64, защото към размерите на съдържанието се добавят вътрешните отстъпи и рамките.
Примери
(() => {
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
console.log(JSON.stringify({
x: rect.x,
y: rect.y,
width: rect.width,
height: rect.height
}));
} finally {
box.remove();
}
})();Резултат
{"x":20,"y":30,"width":124,"height":64}Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.