WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll-snap-align — Ausrichtung von Snap-Positionen

Die Eigenschaft scroll-snap-align legt fest, wie der Snap-Bereich eines Elements beim Einrasten des Scrollens im Container ausgerichtet wird. Sie wird auf den Zielelementen gesetzt; scroll-snap-type gehört auf den Container.

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

Syntax

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

scroll-snap-align definiert die Snap-Positionen eines Elements relativ zum Snapport des Containers. Die Eigenschaft aktiviert das Einrasten nicht selbst: Der Container benötigt ein passendes scroll-snap-type. scroll-margin verändert den Snap-Bereich des Elements, während scroll-padding den Snapport verkleinert.

none definiert in der jeweiligen Achse keine Position; start, end und center richten entsprechend Anfang, Ende und Mitte aus. Ein Wert gilt für beide Achsen. Zwei Werte stehen für Blockachse und danach Inlineachse, also nicht unbedingt für vertikal und horizontal. Der Schreibmodus des Containers bestimmt die Achsen. Bei einem Bereich, der größer als der Snapport ist, legt der Schreibmodus des Elements selbst die Richtungen von start und end fest.

Der Anfangswert ist none; die Eigenschaft wird nicht vererbt und die Animation erfolgt diskret. Im Beispiel deaktiviert none start die Position auf der Blockachse und definiert eine Position am Anfang der Inlineachse. Beim horizontalen Scrollen sollte das Panel schließlich an der linken Kante ausgerichtet sein. Der genaue Ablauf und die Auswahl des Panels hängen vom Browser ab; die Eigenschaft erzwingt keinen Halt an jedem Panel.

Beispiele

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

Ergebnis

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.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen