CKTIS / CSS
scroll-snap-align — alinhamento das posições de encaixe
A propriedade scroll-snap-align especifica como a área de encaixe de um elemento se alinha no respetivo contentor quando o deslocamento se ajusta a uma posição. Define-se nos elementos de destino e scroll-snap-type no contentor.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
scroll-snap-align: [ none | start | end | center ]{1,2};scroll-snap-align define as posições de encaixe de um elemento em relação ao snapport do contentor. Não ativa o encaixe por si só: o contentor precisa de um scroll-snap-type adequado. scroll-margin modifica a área de encaixe do elemento, enquanto scroll-padding reduz o snapport.
none não define qualquer posição nesse eixo; start, end e center alinham, respetivamente, o início, o fim e o centro. Um único valor aplica-se a ambos os eixos. Dois valores correspondem ao eixo de bloco e, em seguida, ao eixo em linha, não necessariamente aos eixos vertical e horizontal. O modo de escrita do contentor determina os eixos. Para uma área maior do que o snapport, o modo de escrita do próprio elemento determina as direções de start e end.
O valor inicial é none; a propriedade não é herdada e a animação é discreta. No exemplo, none start desativa a posição no eixo de bloco e define uma posição no início do eixo em linha. Após o deslocamento horizontal, um painel deverá ficar alinhado com a margem esquerda. O movimento exato e a escolha do painel dependem do navegador; esta propriedade não força uma paragem em cada painel.
Exemplos
<!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>Resultado
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.
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.