CKTIS / JavaScript
Altezza e posizione di scorrimento: offsetHeight, clientHeight e scrollTop
Distingui l’altezza esterna di un elemento, l’altezza della sua area interna e la posizione corrente dello scorrimento verticale. Impara a riconoscere il fondo senza richiedere un’uguaglianza numerica esatta.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
element.offsetHeight // HTMLElement, read-only
element.clientHeight // Element, read-only
element.scrollTop // Element, read
element.scrollTop = y // Element, write a vertical offset in CSS pixelsQueste proprietà fanno parte del DOM del browser, non di ECMAScript. offsetHeight appartiene a HTMLElement; clientHeight e scrollTop appartengono a Element e sono ereditate dagli elementi HTML. Accedi alle proprietà su un’istanza di elemento, ad esempio con el.clientHeight. Tutti i valori sono espressi in pixel CSS.
offsetHeight è l’altezza intera ottenuta dal layout ed è di sola lettura. Normalmente include la spaziatura interna (padding), i bordi e l’eventuale barra di scorrimento orizzontale visualizzata, ma non i margini. Ignora le trasformazioni CSS; per l’altezza del rettangolo di delimitazione dopo una trasformazione, usa el.getBoundingClientRect().height.
clientHeight è l’altezza interna intera ed è di sola lettura. Include la spaziatura interna, ma esclude bordi, margini e barra di scorrimento orizzontale. Entrambe le altezze valgono 0 se display: none sull’elemento o su un antenato lo lascia senza una scatola di layout. Sull’elemento radice del documento (body in modalità quirks), clientHeight restituisce l’altezza del viewport senza la barra di scorrimento orizzontale.
scrollTop legge o imposta lo spostamento verticale rispetto all’origine dello scorrimento. In cima vale normalmente 0, ma può essere frazionario o negativo, ad esempio con flex-direction: column-reverse. In Safari il rimbalzo ai limiti dello scorrimento può produrre temporaneamente valori fuori dall’intervallo normale. L’assegnazione el.scrollTop = y può far scorrere il contenuto con overflow: hidden, ma non con overflow: clip.
scrollHeight è l’altezza intera di tutto il contenuto, compreso quello che deborda fuori dall’area visibile, più la spaziatura interna. In un contenitore che scorre normalmente verso il basso, senza superare i limiti, riconosci il fondo con Math.abs(el.scrollHeight - el.clientHeight - el.scrollTop) <= 1. Usa una tolleranza di un pixel CSS anziché ===, perché scrollTop può essere frazionario. Non usare questo controllo senza modifiche nei layout invertiti.
Esempi
<!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>Risultato
offsetHeight=108 clientHeight=100 scrollHeight=300 scrollTop=40 scrollTop=200 atBottom=true
Salva l’esempio come file HTML, aprilo in un browser e controlla il risultato nella console di sviluppo. I bordi aggiungono 8 px a `offsetHeight`, ma non a `clientHeight`. Il tentativo di scorrere fino a 1000 si ferma a 200, il limite inferiore.
Lezioni correlate
- JavaScript · Lezione 11 · Avanzato · Versione: 4