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

CKTIS / JavaScript

Измерване на височината на ограждащия правоъгълник на елемент

`getBoundingClientRect()` измерва геометрията на елемент спрямо видимата област. `DOMRect.height` дава височината на получения правоъгълник в CSS пиксели.

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

Синтаксис

const rect = element.getBoundingClientRect();
const height = rect.height;

Извикай element.getBoundingClientRect() без аргументи. Този метод на екземпляр на Element връща DOMRect въз основа на списъка от getClientRects(). Ако списъкът е празен, методът връща правоъгълник, чиито x, y, width и height имат стойност 0. Ако всеки правоъгълник в списъка има нулева ширина или нулева височина, методът връща първия правоъгълник, чиято височина все пак може да е ненулева. В противен случай връща най-малкия правоъгълник със страни, успоредни на осите, който обхваща всички правоъгълници с ненулева ширина или височина, включително тези само с един ненулев размер. Координати като top и left са спрямо видимата област и могат да се променят при превъртане. Височината е размер, а не координата.

Прочети rect.height без скоби. Стойността е число в CSS пиксели и може да има дробна част. При прост HTML елемент с една кутия измерването включва съдържанието, вътрешния отстъп (padding) и рамката, но не и външните отстъпи. То отчита CSS трансформациите и затова може да се различава от CSS свойството height и от целочислената височина при оформлението offsetHeight. Ако елементът не създава CSS кутия, например при display: none, височината е 0.

Правоъгълникът отразява състоянието в момента на извикването. След промяна в оформлението или трансформацията измери отново. Присвояването на стойност на rect.height променя само обекта DOMRect, не елемента; в DOMRectReadOnly свойството е само за четене.

Това е уеб API, а не част от ECMAScript 2024. За измерването е нужна среда с DOM и поддръжка на оформление. Провери резултата от querySelector() преди извикването: опитът да извикаш метода върху null води до TypeError, а не до нулева височина.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Bounding rectangle height</title>
</head>
<body>
  <script>
    const box = document.createElement('div');
    box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
    document.body.append(box);

    const before = box.getBoundingClientRect();
    box.style.transform = 'scaleY(0.5)';

    console.log(before.height);
    console.log(box.getBoundingClientRect().height);
    box.remove();
  </script>
</body>
</html>

Резултат

54
27

Запази примера като HTML файл, отвори го в браузър и провери изхода в конзолата на инструментите за разработчици. Запазеният правоъгълник дава `54`; след `scaleY(0.5)` новото измерване дава `27`.

Свързани уроци

  • JavaScript · Урок 11 · Напреднало · Версия: 4

Източници