Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 pixels

Queste 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

Fonti