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