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 April 2022.
Die scroll-snap-type CSS Eigenschaft wird auf einen Scroll-Container angewendet, der damit das Scroll-Snapping aktiviert, indem er die Richtung und Striktheit der Snappoint-Durchsetzung innerhalb des Snappoints festlegt.
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: white;
font-size: 30px;
display: flex;
align-items: center;
justify-content: center;
scroll-snap-align: start;
}
#example-element > div:nth-child(even) {
background-color: white;
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 auf den zuvor eingerasteten Inhalt schnappen, falls dieser noch vorhanden ist.
Wenn der Wert einer scroll-snap-bezogenen 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 schnappen.
Die genaue Animation oder Physik, die zur Durchsetzung dieser Snappoints verwendet wird, ist nicht durch diese Eigenschaft festgelegt, sondern bleibt dem Benutzeragenten überlassen.
Syntax
/* 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 der visuelle Viewport dieses Scroll-Containers gescrollt wird, muss er Snappoints ignorieren.
x-
Der Scroll-Container schnappt nur an Snappositionen auf seiner horizontalen Achse.
y-
Der Scroll-Container schnappt nur an Snappositionen auf seiner vertikalen Achse.
block-
Der Scroll-Container schnappt nur an Snappositionen auf seiner Blockachse.
inline-
Der Scroll-Container schnappt nur an Snappositionen auf seiner Inline-Achse.
both-
Der Scroll-Container schnappt unabhängig an Snappositionen auf beiden Achsen (möglicherweise schnappen verschiedene Elemente auf jeder Achse).
mandatory-
Der visuelle Viewport dieses Scroll-Containers muss an eine Snapposition schnappen, wenn er nicht aktuell gescrollt ist.
proximity-
Der visuelle Viewport dieses Scroll-Containers kann an eine Snapposition schnappen, wenn er nicht aktuell gescrollt ist. Der Benutzeragent entscheidet anhand von Scroll-Parametern, ob er schnappen soll oder nicht. Dies ist die Standard-Snap-Striktheit, wenn eine Snap-Achse angegeben ist.
Formale Definition
| Anfangswert | none |
|---|---|
| Anwendbar auf | alle Elemente |
| Vererbt | Nein |
| Berechneter Wert | wie angegeben |
| Animationstyp | diskret |
Formales Syntax
scroll-snap-type =
none |
[ x | y | block | inline | both ] [ mandatory | proximity ]?
Beispiele
Snappen in verschiedenen Achsen
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
/* 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
Siehe auch
- Andere Scroll-Port-Eigenschaften:
scroll-margin,scroll-padding - Eigenschaften von Scroll-Kindern:
scroll-snap-align,scroll-margin,scroll-snap-stop - Grundkonzepte des CSS Scroll Snap
- Verwenden von Scroll-Snap-Ereignissen
- CSS Scroll Snap
- Gut kontrolliertes Scrollen mit CSS Scroll Snap