scroll-snap-type

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die scroll-snap-type CSS Eigenschaft wird auf einen Scroll-Container gesetzt, um ihn für das Scroll-Snapping zu aktivieren, indem die Richtung und die Strenge der Druckpunkteinbindung innerhalb des Snap-Ports festgelegt werden.

Probieren Sie es aus

scroll-snap-type: none;

scroll-snap-type: x mandatory;

scroll-snap-type: x proximity;

<section class="default-example" id="default-example">
  <div id="example-element">
    <div>1</div>
    <div>2</div>
    <div>3</div>
  </div>
  <div class="info">Scroll »</div>
</section>

.default-example {
  flex-wrap: wrap;
}

.default-example .info {
  width: 100%;
  padding: 0.5em 0;
  font-size: 90%;
}

#example-element {
  text-align: left;
  width: 250px;
  height: 250px;
  overflow-x: scroll;
  display: flex;
  box-sizing: border-box;
  border: 1px solid black;
}

#example-element > div {
  flex: 0 0 250px;
  width: 250px;
  background-color: rebeccapurple;
  color: #fff;
  font-size: 30px;
  display: flex;
  align-items: center;
  justify-content: center;
  scroll-snap-align: start;
}

#example-element > div:nth-child(even) {
  background-color: #fff;
  color: rebeccapurple;
}

Wenn sich der Inhalt im Scroll-Port ändert — zum Beispiel, wenn Inhalt hinzugefügt, verschoben, gelöscht oder in der Größe geändert wird —, wird der Scroll-Container erneut den vorher festgelegten Inhalt einrasten, sofern dieser Inhalt noch vorhanden ist.

Wenn der Wert einer scrollbezogenen Eigenschaft, wie scroll-snap-type oder scroll-margin, geändert wird, wird der Scroll-Container basierend auf dem aktuellen Wert von scroll-snap-type erneut einrasten.

Das Spezifizieren von präzisen Animationen oder Physikmodellen, die verwendet werden, um diese Snap-Punkte durchzusetzen, wird nicht von dieser Eigenschaft abgedeckt, sondern dem Benutzeragenten überlassen.

Syntax

css
/* No snapping */
scroll-snap-type: none;

/* Keyword values for snap axes */
scroll-snap-type: x;
scroll-snap-type: y;
scroll-snap-type: block;
scroll-snap-type: inline;
scroll-snap-type: both;

/* Optional keyword values for snap strictness */
/* mandatory | proximity */
scroll-snap-type: x mandatory;
scroll-snap-type: y proximity;
scroll-snap-type: both mandatory;

/* Global values */
scroll-snap-type: inherit;
scroll-snap-type: initial;
scroll-snap-type: revert;
scroll-snap-type: revert-layer;
scroll-snap-type: unset;

Werte

none

Wenn das visuelle Viewport dieses Scroll-Containers gescrollt wird, muss es Snap-Punkte ignorieren.

x

Der Scroll-Container schnellt nur zu Snap-Positionen auf seiner horizontalen Achse.

y

Der Scroll-Container schnellt nur zu Snap-Positionen auf seiner vertikalen Achse.

block

Der Scroll-Container schnellt nur zu Snap-Positionen auf seiner Block-Achse.

inline

Der Scroll-Container schnellt nur zu Snap-Positionen auf seiner Inline-Achse.

both

Der Scroll-Container schnellt unabhängig zu Snap-Positionen auf beiden seiner Achsen (möglicherweise zu unterschiedlichen Elementen auf jeder Achse).

mandatory

Das visuelle Viewport dieses Scroll-Containers muss zu einer Snap-Position einrasten, wenn es derzeit nicht gescrollt ist.

proximity

Das visuelle Viewport dieses Scroll-Containers darf zu einer Snap-Position einrasten, wenn es derzeit nicht gescrollt ist. Der Benutzeragent entscheidet, ob er einrastet oder nicht, basierend auf Scroll-Parametern. Dies ist die standardmäßige Einraststrenge, wenn eine Snap-Achse angegeben ist.

Formale Definition

Anfangswertnone
Anwendbar aufalle Elemente
VererbtNein
Berechneter Wertwie angegeben
Animationstypdiskret

Formale Syntax

scroll-snap-type = 
  none                                                |
  [ x | y | block | inline | both ] [ mandatory | proximity ]?

Beispiele

Einrasten in verschiedenen Achsen

HTML

html
<main>
  <section class="x mandatory-scroll-snapping" dir="ltr">
    <div>X Mand. LTR</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="x proximity-scroll-snapping" dir="ltr">
    <div>X Prox. LTR</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="y mandatory-scroll-snapping" dir="ltr">
    <div>Y Mand. LTR</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="y proximity-scroll-snapping" dir="ltr">
    <div>Y Prox. LTR</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="x mandatory-scroll-snapping" dir="rtl">
    <div>X Mand. RTL</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="x proximity-scroll-snapping" dir="rtl">
    <div>X Prox. RTL</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="y mandatory-scroll-snapping" dir="rtl">
    <div>Y Mand. RTL</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
  <section class="y proximity-scroll-snapping" dir="rtl">
    <div>Y Prox. RTL</div>
    <div>2</div>
    <div>3</div>
    <div>4</div>
    <div>5</div>
  </section>
</main>

CSS

css
/* scroll-snap */
.x.mandatory-scroll-snapping {
  scroll-snap-type: x mandatory;
}
.x.proximity-scroll-snapping {
  scroll-snap-type: x proximity;
}
.y.mandatory-scroll-snapping {
  scroll-snap-type: y mandatory;
}
.y.proximity-scroll-snapping {
  scroll-snap-type: y proximity;
}

div {
  text-align: center;
  scroll-snap-align: center;
  flex: none;
}

Ergebnisse

Spezifikationen

Specification
CSS Scroll Snap Module Level 1
# scroll-snap-type

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch