Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

scroll-snap-align — allineamento delle posizioni di aggancio

La proprietà scroll-snap-align specifica come l’area di aggancio di un elemento si allinea nel contenitore quando lo scorrimento si assesta su un punto. Si imposta sugli elementi di destinazione, mentre scroll-snap-type si imposta sul contenitore.

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

Sintassi

scroll-snap-align: [ none | start | end | center ]{1,2};

scroll-snap-align definisce le posizioni di aggancio di un elemento rispetto allo snapport del contenitore. Da sola non attiva l’aggancio: il contenitore deve avere un scroll-snap-type adeguato. scroll-margin modifica l’area di aggancio dell’elemento, mentre scroll-padding riduce lo snapport.

none non definisce alcuna posizione sull’asse in questione; start, end e center allineano rispettivamente l’inizio, la fine e il centro. Un solo valore si applica a entrambi gli assi. Due valori indicano prima l’asse del blocco e poi quello inline, non necessariamente gli assi verticale e orizzontale. Gli assi sono determinati dalla modalità di scrittura del contenitore. Per un’area più grande dello snapport, le direzioni di start e end sono determinate dalla modalità di scrittura dell’elemento stesso.

Il valore iniziale è none; la proprietà non è ereditata e l’animazione è discreta. Nell’esempio, none start disattiva la posizione sull’asse del blocco e definisce una posizione all’inizio dell’asse inline. Dopo lo scorrimento orizzontale, un pannello dovrebbe assestarsi allineato al bordo sinistro. Il movimento preciso e la scelta del pannello dipendono dal browser; questa proprietà non impone una sosta su ogni pannello.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>scroll-snap-align</title>
<style>
  .scroller {
    width: 240px;
    height: 100px;
    display: flex;
    overflow-x: auto;
    scroll-snap-type: x mandatory;
    writing-mode: horizontal-tb;
    direction: ltr;
  }
  .item {
    flex: 0 0 240px;
    scroll-snap-align: none start;
    display: grid;
    place-items: center;
    background: #def;
  }
  .item:nth-child(2) { background: #fed; }
</style>
<div class="scroller" tabindex="0" aria-label="Scroll snap demo">
  <div class="item">1</div>
  <div class="item">2</div>
  <div class="item">3</div>
</div>

Risultato

Initially, panel 1 is visible. After horizontal scrolling settles, a panel's left edge aligns with the container's left edge. Expected settled scrollLeft values: 0, 240, or 480 CSS pixels.

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