CKTIS / JavaScript
Височина на елемент и позиция на превъртане: offsetHeight, clientHeight и scrollTop
Разграничи външната височина на елемента, височината на вътрешната му област и текущата позиция на вертикално превъртане. Научи как да откриваш долния край, без да изискваш точно числово равенство.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.offsetHeight // HTMLElement, read-only
element.clientHeight // Element, read-only
element.scrollTop // Element, read
element.scrollTop = y // Element, write a vertical offset in CSS pixelsТова са свойства на DOM в браузъра, а не част от ECMAScript. offsetHeight принадлежи на интерфейса HTMLElement; clientHeight и scrollTop принадлежат на Element и се наследяват от HTML елементите. Достъпвай ги върху конкретен елемент, например чрез el.clientHeight. Всички стойности са в CSS пиксели.
offsetHeight е целочислената височина в оформлението и е само за четене. Обикновено включва вътрешния отстъп (padding), рамката и хоризонталната лента за превъртане, ако е изобразена, но не и външния отстъп. Не отчита CSS трансформации; за височината на ограждащия правоъгълник след трансформация използвай el.getBoundingClientRect().height.
clientHeight е целочислената вътрешна височина и е само за четене. Тя включва вътрешния отстъп, но не включва рамката, външния отстъп или хоризонталната лента за превъртане. И двете височини са 0, ако display: none върху елемента или негов предшественик го оставя без кутия в оформлението. За кореновия елемент на документа (body в режим quirks) clientHeight връща височината на видимата област на документа без хоризонталната лента за превъртане.
scrollTop чете или задава вертикалното отместване спрямо началото на превъртането. Най-горе обикновено е 0, но може да има дробна част или да е отрицателно, например при flex-direction: column-reverse. При отскачане в края на превъртането Safari може временно да отчете стойности извън нормалния диапазон. Присвояването el.scrollTop = y може да превърта съдържание с overflow: hidden, но не и с overflow: clip.
scrollHeight е целочислената височина на цялото съдържание, включително частта извън видимата област, плюс вътрешния отстъп. В обикновен контейнер, който се превърта надолу, без да преминава границите си, открий долния край с Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Използвай допуск от един CSS пиксел вместо ===, защото scrollTop може да има дробна част. Не прилагай тази проверка без промени при обърнато оформление.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element height and scroll position</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
box.style.cssText = 'position:fixed;top:0;left:0;width:160px;height:100px;' +
'box-sizing:content-box;padding:0;border:4px solid;overflow:hidden;' +
'scroll-behavior:auto;writing-mode:horizontal-tb;';
const content = document.createElement('div');
content.style.height = '300px';
box.append(content);
document.body.append(box);
try {
box.scrollTop = 40;
console.log(`offsetHeight=${box.offsetHeight} clientHeight=${box.clientHeight} scrollHeight=${box.scrollHeight} scrollTop=${box.scrollTop}`);
box.scrollTop = 1000;
const atBottom = Math.abs(box.scrollHeight - box.clientHeight - box.scrollTop) <= 1;
console.log(`scrollTop=${box.scrollTop} atBottom=${atBottom}`);
} finally {
box.remove();
}
})();
</script>
</body>
</html>Резултат
offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40 scrollTop=200 atBottom=true
Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Рамката добавя 8 px към `offsetHeight`, но не и към `clientHeight`. Опитът за превъртане до 1000 спира на 200, долната граница.
Свързани уроци
- JavaScript · Урок 11 · Напреднало · Версия: 4