Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Višina elementa in položaj drsenja: offsetHeight, clientHeight in scrollTop

Loči zunanjo višino elementa, višino njegovega notranjega območja in trenutni položaj navpičnega drsenja. Nauči se zaznati spodnji rob brez preverjanja natančne številske enakosti.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

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 so lastnosti DOM-a v brskalniku, ne del ECMAScripta. offsetHeight pripada vmesniku HTMLElement; clientHeight in scrollTop pripadata vmesniku Element in ju elementi HTML podedujejo. Do lastnosti dostopaj na primerku elementa, na primer z el.clientHeight. Vse vrednosti so izražene v slikovnih pikah CSS.

offsetHeight je celoštevilska višina škatle v postavitvi in je na voljo samo za branje. Običajno vključuje notranji odmik (padding), obrobo in vodoravni drsni trak, če je prikazan, ne pa zunanjega odmika. Pretvorb CSS ne upošteva; za višino omejevalnega pravokotnika po pretvorbi uporabi el.getBoundingClientRect().height.

clientHeight je celoštevilska notranja višina in je na voljo samo za branje. Vključuje notranji odmik, ne pa obrobe, zunanjega odmika ali vodoravnega drsnega traku. Obe višini sta 0, če element zaradi display: none na njem ali na predniku nima škatle v postavitvi. Na korenskem elementu dokumenta (body v načinu quirks) clientHeight poda višino vidnega polja brez vodoravnega drsnega traku.

scrollTop prebere ali nastavi navpični odmik od izhodišča drsenja. Na vrhu je običajno 0, lahko pa ima decimalni del ali je negativen, na primer pri flex-direction: column-reverse. Odboj na meji drsenja lahko v Safariju začasno vrne vrednosti zunaj običajnega razpona. Prireditev el.scrollTop = y omogoča drsenje vsebine pri overflow: hidden, pri overflow: clip pa ne.

scrollHeight je celoštevilska višina celotne vsebine, vključno z delom zunaj vidnega območja in notranjim odmikom. V običajnem vsebniku z drsenjem navzdol, brez preseganja meja, zaznaj spodnji rob z Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Namesto === uporabi toleranco ene slikovne pike CSS, saj ima scrollTop lahko decimalni del. Pri obrnjenih postavitvah tega preizkusa ne uporabi brez prilagoditev.

Primeri

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

Rezultat

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

Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Obroba doda 8 px k `offsetHeight`, ne pa k `clientHeight`. Poskus drsenja na 1000 se ustavi pri 200, na spodnji meji.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredna · Različica: 4

Viri