CSS scroll-behavior
La proprietà CSS3 scroll-behavior controlla il comportamento dello scorrimento
La proprietà scroll-behavior
definisce se lo scorrimento di una pagina deve avvenire in modo istantaneo o con una transizione fluida. È comunemente applicata al tag html
per abilitare l'effetto su tutta la pagina o a contenitori scrollabili.
Sintassi
Significato dei valori principali:
-
auto: valore predefinito. Lo scorrimento avviene immediatamente senza animazione.
-
smooth: applica uno scorrimento fluido animato, utile per migliorare la leggibilità nei salti di ancoraggio.
Esempio proprietà: scroll-behavior
Codice Esempio: scroll-behavior

html {
scroll-behavior: smooth;
}
.scroll-target {
margin-top: 1000px;
height: 200px;
background-color: #50a14f;
color: white;
display: flex;
align-items: center;
justify-content: center;
font-size: 24px;
border-radius: 8px;
}
.scroll-link {
font-size: 20px;
color: #ff6347;
text-decoration: underline;
cursor: pointer;
}
Contenuto Esempio: scroll-behavior
Esempio di utilizzo di scroll-behavior
In questo esempio, cliccando sul link si effettua uno scorrimento fluido verso il secondo box:
CSS e HTML per scroll-behavior:
<style>
html {
scroll-behavior: smooth;
}
.scroll-target {
margin-top: 1000px;
height: 200px;
background-color: #50a14f;
color: white;
display: flex;
align-items: center;
justify-content: center;
font-size: 24px;
border-radius: 8px;
}
.scroll-link {
font-size: 20px;
color: #ff6347;
text-decoration: underline;
cursor: pointer;
}
</style>
<a href="#target" class="scroll-link">Vai al box in basso</a>
<div id="target" class="scroll-target">
Hai raggiunto il box con scorrimento fluido!
</div>
📌 Nota sull’utilizzo delle proprietà scroll-*
Le proprietà della famiglia scroll-*
offrono controllo preciso sul comportamento e sul posizionamento dello scroll nei contenitori overflow. Tuttavia, la loro efficacia può variare in base al tipo di interazione, al contesto e al metodo di attivazione dello scroll. Di seguito una panoramica generale:
-
scroll-behavior
: controlla se lo scroll avviene in modo fluido (smooth
) o istantaneo (auto
). È supportata in interazioni utente (tastiera, mouse) e via JavaScript con metodi comescrollIntoView()
oscrollTo()
. -
scroll-margin*
: imposta uno spazio esterno virtuale tra il target dello scroll e il bordo del contenitore. È utile per evitare che l’elemento scrollato venga troppo "incollato" al bordo. Agisce solo quando l’elemento è il target di scroll (es.scrollIntoView()
). -
scroll-padding*
: definisce un’area interna del contenitore da considerare come "bordo attivo" per gli snap o il focus di scroll. È efficace nei contenitori conscroll-snap-type
attivo o nei layout con focus automatico. -
scroll-snap-type
: abilita lo snap agli elementi figlio durante lo scroll, obbligando (o suggerendo) l’aggancio al più vicino snap-point. Richiede layout a scorrimento (overflow
) e funzionerà solo se associato a elementi figli conscroll-snap-align
. -
scroll-snap-align
: definisce dove un elemento figlio deve "agganciarsi" all'interno del contenitore scrollabile (es. inizio, centro, fine). Funziona solo se il contenitore hascroll-snap-type
. -
scroll-snap-stop
: impedisce che l’elemento venga saltato durante uno scroll veloce. Utile per forzare lo stop su sezioni importanti, ma funziona solo con scroll naturali (touch, tastiera, oscrollIntoView
), non conscrollTo({ left: ... })
.
Compatibilità e contesto: molte di queste proprietà funzionano meglio con interazioni naturali (touchpad, touchscreen, tastiera) e possono non comportarsi come previsto quando lo scroll è simulato in modo diretto con JavaScript. Per ottenere effetti coerenti, è consigliato usare layout con display: flex
o grid
, dimensioni fisse e contenitori overflow con scroll-snap-type
attivo.
Note:
Le indicazioni dei Browser supportati sono superate grazie alla loro costante evoluzione, si consiglia di verificare la compatibilità dei vari browser eseguendo il test cliccando qui sotto.