Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

scroll-snap-align — alineación de las posiciones de ajuste

La propiedad scroll-snap-align especifica cómo se alinea el área de ajuste de un elemento dentro de su contenedor cuando el desplazamiento se ajusta a una posición. Se establece en los elementos de destino y scroll-snap-type, en el contenedor.

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

Sintaxis

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

scroll-snap-align define las posiciones de ajuste de un elemento con respecto al snapport del contenedor. No activa el ajuste por sí sola: el contenedor necesita un scroll-snap-type adecuado. scroll-margin modifica el área de ajuste del elemento, mientras que scroll-padding reduce el snapport.

none no define ninguna posición en ese eje; start, end y center alinean, respectivamente, el inicio, el final y el centro. Un solo valor se aplica a ambos ejes. Dos valores indican primero el eje de bloque y después el eje en línea, que no tienen por qué ser los ejes vertical y horizontal. El modo de escritura del contenedor determina los ejes. Si el área es mayor que el snapport, el modo de escritura del propio elemento determina las direcciones de start y end.

El valor inicial es none; la propiedad no se hereda y su animación es discreta. En el ejemplo, none start desactiva la posición del eje de bloque y define una posición al inicio del eje en línea. Tras el desplazamiento horizontal, un panel debería quedar alineado con el borde izquierdo. El movimiento exacto y la selección del panel dependen del navegador; esta propiedad no obliga a detenerse en cada panel.

Ejemplos

<!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.

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes