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