Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wysokość elementu i pozycja przewijania: offsetHeight, clientHeight i scrollTop

Rozróżnij wysokość zewnętrzną elementu, wysokość jego obszaru wewnętrznego oraz bieżącą pozycję przewijania w pionie. Naucz się wykrywać dolny koniec przewijania bez porównywania liczb na ścisłą równość.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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

To właściwości przeglądarkowego API DOM, a nie część ECMAScriptu. offsetHeight należy do HTMLElement; clientHeight i scrollTop należą do Element i są dziedziczone przez elementy HTML. Odczytuj je z instancji elementu, np. el.clientHeight. Wszystkie te wartości są wyrażone w pikselach CSS.

offsetHeight to całkowitoliczbowa wysokość w układzie strony, tylko do odczytu. Zwykle obejmuje dopełnienie (padding), obramowanie i poziomy pasek przewijania, jeśli jest renderowany, ale nie margines. Nie uwzględnia transformacji CSS; jeśli potrzebujesz wysokości prostokąta ograniczającego po transformacji, użyj el.getBoundingClientRect().height.

clientHeight to całkowitoliczbowa wysokość wewnętrzna, tylko do odczytu. Obejmuje dopełnienie, ale nie obramowanie, margines ani poziomy pasek przewijania. Obie wysokości wynoszą 0, gdy display: none na elemencie lub jego przodku sprawia, że element nie ma pola układu. clientHeight na elemencie głównym dokumentu (na body w trybie quirks) zwraca wysokość obszaru widoku bez poziomego paska przewijania.

scrollTop odczytuje lub ustawia pionowe przesunięcie przewijania względem pozycji początkowej. Zwykle na górze wynosi 0, ale może mieć część ułamkową lub być ujemne, np. przy flex-direction: column-reverse. W Safari efekt odbicia przy przewijaniu może chwilowo dać wartość poza normalnym zakresem. Przypisanie el.scrollTop = y może przewinąć zawartość przy overflow: hidden, ale nie przy overflow: clip.

scrollHeight to całkowitoliczbowa wysokość całej zawartości, także części poza widocznym obszarem, wraz z dopełnieniem. W zwykłym kontenerze przewijanym w dół, bez efektu odbicia, wykryj dolny koniec przez Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Użyj tolerancji jednego piksela CSS zamiast ===, bo scrollTop może być ułamkowe. Nie stosuj tego testu bez zmian do odwróconego kierunku układu.

Przykłady

<!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>

Wynik

offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40
scrollTop=200 atBottom=true

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Obramowanie dodaje łącznie 8 px do `offsetHeight`, ale nie do `clientHeight`. Próba ustawienia przesunięcia na 1000 kończy się na 200, czyli na dolnej granicy.

Powiązane lekcje

  • JavaScript · Lekcja 11 · Zaawansowany · Wersja: 4

Źródła