scroll-snap-points-x

Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. 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.

Non-standard: This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The scroll-snap-points-x CSS property defines the horizontal positioning of snap points within the content of the scroll container they are applied to.

/* Keyword value */
scroll-snap-points-x: none;

/* Repeating snap points */
scroll-snap-points-x: repeat(400px);

/* Global values */
scroll-snap-points-x: inherit;
scroll-snap-points-x: initial;
scroll-snap-points-x: 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 definition

Initial valuenone
Applies toscroll containers
Inheritedno
Percentagesrelative to same axis of the padding-box of the scroll container
Computed valueas specified, but with relative lengths converted into absolute lengths
Animation typediscrete

Formal syntax

scroll-snap-points-x =
  none | repeat( <length-percentage> )

Examples

Setting horizontal scroll snap points

HTML

<div id="container">
  <div>1</div>
  <div>2</div>
  <div>3</div>
</div>

CSS

#container {
  width: 200px;
  overflow: auto;
  white-space: nowrap;
  scroll-snap-points-x: repeat(100%);
  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;
}

Result

Specifications

Not part of any standard.

Browser compatibility

BCD tables only load in the browser

See also