Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Visina elementa i položaj pomicanja: offsetHeight, clientHeight i scrollTop

Razlikuj vanjsku visinu elementa, visinu njegova unutarnjeg područja i trenutačni položaj okomitog pomicanja. Nauči prepoznati donji kraj bez provjere točne brojčane jednakosti.

Verzija: 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 su svojstva DOM-a u pregledniku, a ne dio ECMAScripta. offsetHeight pripada sučelju HTMLElement; clientHeight i scrollTop pripadaju sučelju Element i nasljeđuju ih HTML elementi. Pristupi im na instanci elementa, primjerice s el.clientHeight. Sve se vrijednosti izražavaju u CSS pikselima.

offsetHeight je cjelobrojna visina elementa u rasporedu i dostupna je samo za čitanje. Obično uključuje unutarnji razmak (padding), obrub i vodoravnu kliznu traku ako je prikazana, ali ne i vanjsku marginu. Ne uzima u obzir CSS transformacije; za visinu graničnog pravokutnika nakon transformacije upotrijebi el.getBoundingClientRect().height.

clientHeight je cjelobrojna unutarnja visina i dostupna je samo za čitanje. Uključuje unutarnji razmak, ali ne obrub, vanjsku marginu ni vodoravnu kliznu traku. Obje visine iznose 0 ako element nema okvir u rasporedu zbog display: none na njemu ili na njegovu pretku. Na korijenskom elementu dokumenta (body u načinu rada quirks), clientHeight mjeri visinu područja prikaza bez vodoravne klizne trake.

scrollTop čita ili postavlja okomiti pomak u odnosu na ishodište pomicanja. Na vrhu je obično 0, ali može imati decimalni dio ili biti negativan, primjerice uz flex-direction: column-reverse. Safari pri odskoku na granici pomicanja može privremeno vratiti vrijednosti izvan uobičajenog raspona. Dodjela el.scrollTop = y može pomicati sadržaj uz overflow: hidden, ali ne uz overflow: clip.

scrollHeight je cjelobrojna visina cjelokupnog sadržaja, uključujući dio izvan vidljivog područja i unutarnji razmak. U običnom spremniku koji se pomiče prema dolje bez prelaska granica prepoznaj donji kraj izrazom Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Umjesto === koristi toleranciju od jednog CSS piksela jer scrollTop može imati decimalni dio. Nemoj taj test primijeniti bez prilagodbi na obrnute rasporede.

Primjeri

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u razvojnoj konzoli. Obrub dodaje 8 px vrijednosti `offsetHeight`, ali ne i vrijednosti `clientHeight`. Pokušaj pomicanja na 1000 zaustavlja se na 200, donjoj granici.

Povezane lekcije

  • JavaScript · Lekcija 11 · Napredno · Verzija: 4

Izvori