Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Výška prvku a poloha posunu: offsetHeight, clientHeight a scrollTop

Rozlišujte vnější výšku prvku, výšku jeho vnitřní oblasti a aktuální polohu svislého posunu. Zjistěte, jak poznat dolní konec bez přesné číselné rovnosti.

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

Syntaxe

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

Jde o vlastnosti prohlížečového DOM, nikoli o součást ECMAScriptu. offsetHeight patří rozhraní HTMLElement; clientHeight a scrollTop patří rozhraní Element a prvky HTML je dědí. Přistupujte k nim na instanci prvku, například pomocí el.clientHeight. Všechny hodnoty jsou v pixelech CSS.

offsetHeight je celočíselná výška v rozvržení, dostupná pouze pro čtení. Obvykle zahrnuje vnitřní odsazení (padding), rámeček a případně vykreslený vodorovný posuvník, ale ne vnější okraje. Transformace CSS nezohledňuje; pro výšku ohraničujícího obdélníku po transformaci použijte el.getBoundingClientRect().height.

clientHeight je celočíselná vnitřní výška, dostupná pouze pro čtení. Zahrnuje vnitřní odsazení, ale ne rámeček, vnější okraje ani vodorovný posuvník. Obě výšky jsou 0, pokud kvůli display: none na prvku nebo jeho předkovi prvek nemá v rozvržení žádný box. U kořenového prvku dokumentu (body v režimu quirks) vrací clientHeight výšku zobrazovací oblasti bez vodorovného posuvníku.

scrollTop čte nebo nastavuje svislý posun vzhledem k jeho počátku. Nahoře bývá 0, ale hodnota může být desetinná nebo záporná, například při flex-direction: column-reverse. Efekt pružného odrazu na hranici posunu může v Safari dočasně vracet hodnoty mimo běžný rozsah. Příkaz el.scrollTop = y umožňuje posunout obsah při overflow: hidden, nikoli při overflow: clip.

scrollHeight je celočíselná výška celého obsahu včetně části přesahující mimo viditelnou oblast a vnitřního odsazení. U běžného kontejneru s posunem dolů bez překročení mezí zjistíte dolní konec pomocí Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Místo === použijte toleranci jednoho pixelu CSS, protože scrollTop může být desetinné. U obráceného rozvržení nepoužívejte tento test beze změny.

Příklady

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

Výsledek

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

Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup ve vývojářské konzoli. Rámeček přidá 8 px k `offsetHeight`, ale ne k `clientHeight`. Pokus o posun na 1000 skončí na 200, tedy na dolní mezi.

Související lekce

  • JavaScript · Lekce 11 · Pokročilá · Verze: 4

Zdroje