Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

scroll-snap-align — alignement des positions d’accrochage

La propriété scroll-snap-align définit l’alignement de la zone d’accrochage d’un élément dans son conteneur lorsque le défilement s’arrête sur un point d’accrochage. Elle se règle sur les éléments cibles, tandis que scroll-snap-type se règle sur le conteneur.

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

Syntaxe

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

scroll-snap-align définit les positions d’accrochage d’un élément par rapport au snapport du conteneur. Elle n’active pas l’accrochage à elle seule : le conteneur doit avoir un scroll-snap-type approprié. scroll-margin modifie la zone d’accrochage de l’élément, tandis que scroll-padding réduit le snapport.

none ne définit aucune position sur l’axe concerné ; start, end et center alignent respectivement le début, la fin et le centre. Une seule valeur s’applique aux deux axes. Deux valeurs correspondent à l’axe de bloc, puis à l’axe en ligne, et non nécessairement aux axes vertical puis horizontal. Le mode d’écriture du conteneur détermine les axes. Pour une zone plus grande que le snapport, le mode d’écriture de l’élément lui-même détermine les directions de start et end.

La valeur initiale est none ; la propriété n’est pas héritée et son animation est discrète. Dans l’exemple, none start désactive la position sur l’axe de bloc et définit une position au début de l’axe en ligne. Après un défilement horizontal, un panneau devrait se retrouver aligné sur le bord gauche. Le mouvement exact et le choix du panneau dépendent du navigateur ; cette propriété ne force pas l’arrêt sur chaque panneau.

Exemples

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

Résultat

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.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources