CKTIS / JavaScript
Elementhoogte en scrollpositie: offsetHeight, clientHeight en scrollTop
Maak onderscheid tussen de hoogte van de buitenste elementbox, de hoogte van het binnengebied en de huidige verticale scrollpositie. Leer het onderste punt te herkennen zonder exacte gelijkheid te vereisen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.offsetHeight // HTMLElement, read-only
element.clientHeight // Element, read-only
element.scrollTop // Element, read
element.scrollTop = y // Element, write a vertical offset in CSS pixelsDit zijn eigenschappen van de browser-DOM, geen onderdeel van ECMAScript. offsetHeight hoort bij HTMLElement; clientHeight en scrollTop horen bij Element en worden door HTML-elementen geërfd. Lees ze op een elementinstantie, bijvoorbeeld met el.clientHeight. Alle waarden zijn uitgedrukt in CSS-pixels.
offsetHeight geeft de lay-outhoogte als geheel getal en is alleen-lezen. Deze hoogte omvat normaal de binnenruimte (padding), de randen en een eventueel weergegeven horizontale schuifbalk, maar niet de marges. CSS-transformaties tellen niet mee. Gebruik el.getBoundingClientRect().height voor de hoogte van de omsluitende rechthoek na een transformatie.
clientHeight geeft de binnenhoogte als geheel getal en is alleen-lezen. De binnenruimte telt mee, maar de randen, marges en horizontale schuifbalk niet. Beide hoogtes zijn 0 als display: none op het element of een voorouder ervoor zorgt dat het element geen lay-outbox heeft. Op het hoofdelement van het document (body in quirksmodus) meet clientHeight de hoogte van het weergavegebied zonder horizontale schuifbalk.
scrollTop leest of wijzigt de verticale scrollafstand ten opzichte van het scrollbeginpunt. Bovenaan is de waarde meestal 0, maar ze kan een fractie of negatief zijn, bijvoorbeeld bij flex-direction: column-reverse. Het terugveereffect aan de scrollgrens kan in Safari tijdelijk waarden buiten het normale bereik opleveren. Met el.scrollTop = y kun je inhoud scrollen bij overflow: hidden, maar niet bij overflow: clip.
scrollHeight is de gehele hoogte van alle inhoud, inclusief wat buiten het zichtbare gebied valt, plus de binnenruimte. Voor een container die normaal omlaag scrolt, zonder voorbij de scrollgrens te gaan, herken je het onderste punt met Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Gebruik een marge van één CSS-pixel in plaats van ===, omdat scrollTop een fractie kan zijn. Pas deze controle niet ongewijzigd toe op een omgekeerde lay-out.
Voorbeelden
<!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>Resultaat
offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40 scrollTop=200 atBottom=true
Sla het voorbeeld op als HTML-bestand, open het in een browser en controleer de uitvoer in de ontwikkelaarsconsole. De randen voegen 8 px toe aan `offsetHeight`, maar niet aan `clientHeight`. De poging om naar 1000 te scrollen stopt bij 200, de ondergrens.
Gerelateerde lessen
- JavaScript · Les 11 · Gevorderd · Versie: 4