This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Avoid using it and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Summary
The scroll-snap-points-y CSS property defines the vertical positioning of snap points within the content of the scroll container they are applied to.
| Initial value | none |
|---|---|
| Applies to | scroll containers |
| Inherited | no |
| Percentages | relative to same axis of the padding-box of the scroll container |
| Media | interactive |
| Computed value | as specified, but with relative lengths converted into absolute lengths |
| Animation type | discrete |
| Canonical order | the unique non-ambiguous order defined by the formal grammar |
Syntax
/* Keyword value */ scroll-snap-points-y: none; /* Repeated snap points */ scroll-snap-points-y: repeat(400px); /* Global values */ scroll-snap-points-y: inherit; scroll-snap-points-y: initial; scroll-snap-points-y: unset;
Values
none- The scroll container does not define any snap points. Elements within the scroll container may still define snap points on behalf of the scroll container.
repeat(<length>)- Defines an interval at which snap points are defined, starting from the container's relevant start edge. Only positive lengths are allowed.
Formal syntax
none | repeat(<length>)
Example
HTML Content
<div id="container"> <div>1</div> <div>2</div> <div>3</div> </div>
CSS Content
#container {
height: 200px;
width: 220px;
overflow-x: hidden;
overflow-y: auto;
scroll-snap-points-y: repeat(200px);
scroll-snap-type: mandatory;
font-size: 0;
}
#container > div {
width: 200px;
height: 200px;
display: inline-block;
line-height: 200px;
text-align: center;
font-size: 100px;
}
#container > div:nth-child(even) {
background-color: #87EA87;
}
#container > div:nth-child(odd) {
background-color: #87CCEA;
}
Specification
This property was once defined in the early draft of CSS Scroll Snap Points Module but later removed from the specification in favor of element-based snapping.
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | No support | 39.0 (39.0) | No support | No support | 9-webkit |
| Feature | Android | Firefox Mobile (Gecko) | Firefox OS | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | No support | 39.0 (39.0)[1] | 39.0 (39.0) | No support | No support | 9-webkit |
[1] On Firefox Mobile, available since Gecko 39, but behind the preference layout.css.vertical-text.enabled, disabled by default.