scroll-snap-points-y

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.

/* 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;

Syntax

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-percentage>)

Defines an interval at which snap points are defined, starting from the container's relevant start edge. Only positive lengths are allowed. Percentages refer to the width of the container.

Formal syntax

none | repeat( <length-percentage> )
where 
<length-percentage> = <length> | <percentage>

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 compatibilityUpdate compatibility data on GitHub