CKTIS / JavaScript
Ограничаващ правоъгълник и отмествания на клиентската област
Измери позицията и размера на елемент спрямо областта за показване и ги разграничи от лявото и горното отместване на клиентската му област.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.getBoundingClientRect() // DOMRect
element.clientLeft // integer Number
element.clientTop // integer Numberelement.getBoundingClientRect() е метод на Element без аргументи. Връща DOMRect въз основа на правоъгълниците, които getClientRects() връща за кутиите до външния край на рамките им след прилагане на трансформациите. Ако списъкът е празен, всички стойности са нула. Ако всеки правоъгълник в списъка има нулева ширина или височина, методът връща първия правоъгълник от списъка. В противен случай връща най-малкия правоъгълник със страни, успоредни на осите, който обхваща правоъгълниците с ненулева ширина или височина. Включва вътрешния отстъп и рамката, но не външния отстъп. left и top са координати спрямо горния ляв ъгъл на областта за показване, а width и height са размери. Стойностите са в CSS пиксели и може да са дробни.
element.clientLeft и element.clientTop са свойства само за четене, а не методи. Те дават целочислени отмествания в CSS пиксели, без да отчитат трансформации: дебелината съответно на лявата и горната рамка плюс мястото, заемано от лента за превъртане от същата страна, ако има такава. Вертикалната лента може да е отляво, например при оформление отдясно наляво. Вътрешният и външният отстъп не се включват. И двете свойства връщат нула за вътрередова кутия или при липса на CSS кутия.
DOMRect отразява състоянието в момента на измерването. Измери отново след превъртане или промяна на оформлението, ако ти трябват актуални координати. За координати спрямо документа прибави window.scrollX към left и window.scrollY към top. Не използвай clientLeft и clientTop като координати спрямо областта за показване или като общ начин за преобразуване на координати след трансформация. Това са интерфейси на уеб платформата (CSSOM View), а не част от ECMAScript 2024; наличността им зависи от средата за изпълнение.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element geometry</title>
</head>
<body>
<script>
(() => {
// Use a 1:1 ratio so the borders need no device-pixel rounding.
if (window.devicePixelRatio !== 1) {
throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
}
const box = document.createElement('div');
box.style.cssText = `
position: fixed; left: 20px; top: 30px;
box-sizing: border-box; width: 80px; height: 40px;
border: solid black; border-width: 5px 2px 2px 3px;
overflow: hidden; transform-origin: top left; transform: scale(2);
`;
document.body.append(box);
try {
const { left, top, width, height } = box.getBoundingClientRect();
console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Резултат
rect: 20, 30, 160, 80 client: 3, 5
Отвори HTML документа в браузър при мащабиране на страницата 100% и стойност на `devicePixelRatio`, равна на `1`. Виж резултата в конзолата на браузъра. Промяната на мащаба удвоява размерите на правоъгълника, без да премества горния му ляв ъгъл; отместванията остават `3` и `5`.
Свързани уроци
- JavaScript · Урок 35 · Напреднало · Версия: 4