Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes