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

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}

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници