База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Ограничаващ правоъгълник и отмествания на клиентската област

Измери позицията и размера на елемент спрямо областта за показване и ги разграничи от лявото и горното отместване на клиентската му област.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

element.getBoundingClientRect() // DOMRect
 element.clientLeft // integer Number
 element.clientTop // integer Number

element.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

Източници