CKTIS / JavaScript
Element.getBoundingClientRect(): размери и позиция на DOMRect
Измери ограждащия правоъгълник на елемент в CSS пиксели и разграничи координатите спрямо областта за показване от тези на документа.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const rect = element.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;element.getBoundingClientRect() не приема аргументи и връща обект DOMRect. Това е уеб API, а не част от ECMAScript. За измерването е нужна среда, която изчислява оформлението на DOM; наличността зависи от средата за изпълнение.
За HTML елемент измерването се основава на правоъгълници със страни, успоредни на осите, които съответстват на CSS кутиите му до външния ръб на рамките. То включва вътрешния отстъп и рамките, отчита CSS трансформациите и не включва външните отстъпи. За отделните правоъгълници използвай getClientRects(). Ако списъкът е празен, например при display: none, всички стойности са нула. Ако всеки правоъгълник има нулева ширина или нулева височина, методът връща първия правоъгълник в списъка. В противен случай връща най-малкия правоъгълник, който обхваща всички правоъгълници в списъка освен тези, чиито два размера са нула. При редови елемент на няколко реда резултатът може да обхване и празнини между фрагментите. Самият правоъгълник не доказва, че елементът е видим.
width и height са размерите на правоъгълника. В този резултат x и y съвпадат с left и top; right е left + width, а bottom е top + height. Координатите се измерват от горния ляв ъгъл на областта за показване, а не от най-близкия ѝ ръб, и могат да бъдат отрицателни. Всички стойности са в CSS пиксели и могат да имат дробна част.
В DOMRect можеш да променяш x, y, width и height; координатите на ръбовете се изчисляват и са само за четене. При ръчно създаден правоъгълник с отрицателна стойност на width или height, x може да се различава от left, а y — от top. Промяната на резултата не променя елемента. Резултатът отразява състоянието в момента на измерването: измери отново след промяна в оформлението или превъртане, ако са ти нужни актуални стойности.
За горния ляв ъгъл в координати на документа използвай rect.left + window.scrollX и rect.top + window.scrollY, като отчетеш отместванията при измерването. Това сменя началото на координатната система, но не отменя ефекта от превъртането във вложен контейнер.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Measuring an element</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'position: fixed; left: 24.5px; top: 16px; margin: 0; box-sizing: content-box; width: 104px; height: 44px; padding: 8px; border: 0;';
document.body.append(box);
try {
const rect = box.getBoundingClientRect();
const { x, y, width, height, top, right, bottom, left } = rect;
console.log(`x=${x}, y=${y}, width=${width}, height=${height}, top=${top}, right=${right}, bottom=${bottom}, left=${left}`);
box.style.left = '44.5px';
console.log(`previous x=${rect.x}, current x=${box.getBoundingClientRect().x}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Резултат
x=24.5, y=16, width=120, height=60, top=16, right=144.5, bottom=76, left=24.5 previous x=24.5, current x=44.5
Запази примера като HTML файл, отвори го в браузър и виж изхода в конзолата за разработчици. Размерите включват вътрешния отстъп от двете страни на всяка ос; елементът няма рамка. След преместването на елемента предишният правоъгълник запазва първоначалното си `x`; само ново измерване дава новото `x`.
Свързани уроци
- JavaScript · Урок 12 · Напреднало · Версия: 4