Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

scroll-behavior — comportamento dello scorrimento

La proprietà scroll-behavior stabilisce se lo scorrimento avviato dalla navigazione o da un’API è immediato o fluido. Non controlla lo scorrimento diretto dell’utente.

Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintassi

scroll-behavior: auto | smooth;

scroll-behavior si applica ai contenitori scorrevoli. Il valore iniziale auto indica uno scorrimento immediato; smooth indica un movimento con durata e andamento definiti dal browser. La proprietà non è ereditata né animabile.

Riguarda la navigazione, le API di scorrimento e le operazioni di aggancio dello scorrimento non avviate dall’utente. Non modifica lo scorrimento diretto tramite gesti o rotellina. Su html controlla la viewport della pagina; impostarla su body non la trasferisce a tale viewport. I browser possono ignorarla.

Nell’esempio, overflow: auto e un’altezza limitata creano un contenitore scorrevole. La chiamata a scrollTo() con behavior: 'auto' consulta il valore calcolato di scroll-behavior e può quindi avviare un movimento fluido. Non è la stessa cosa di CSS scroll-behavior: auto. Controlla la posizione finale, non una durata fissa dell’animazione.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-behavior</title>
<style>
  #panel {
    height: 120px;
    overflow: auto;
    scroll-behavior: smooth;
    border: 1px solid;
  }
  #content { height: 600px; }
</style>
<button id="go" type="button">Scroll to 240px</button>
<div id="panel" tabindex="0" aria-label="Scrollable example">
  <div id="content">Scrollable content</div>
</div>
<script>
  const panel = document.getElementById('panel');
  document.getElementById('go').addEventListener('click', () => {
    panel.scrollTo({ top: 240, behavior: 'auto' });
  });
</script>
</html>

Risultato

After scrolling completes without interruption: panel.scrollTop === 240. No console output.

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti