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

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

Източници