-ms-scroll-snap-points-y

The -ms-scroll-snap-points-y CSS property is a Microsoft extension that specifies where snap-points will be located along the y-axis.

Syntax

Values

snapInterval( <length-percentage>, <length-percentage> )

Specifies a starting snap-point followed by the interval between all snap-points.

• The first value specifies where the first snap-point will be placed.
• The second value specifies the distance between subsequent snap-points both above and below the initial snap-point.

snapList( <length-percentage># )

Specifies the position of individual snap-points as a comma-separated list of values, each of which represents a zoom factor.

• If any value is less than -ms-scroll-limit-y-min , then -ms-scroll-limit-y-min is used.
• If any value is greater than -ms-scroll-limit-y-max, then -ms-scroll-limit-y-max is used.

Formal syntax

  snapInterval( <length-percentage>, <length-percentage> ) | snapList( <length-percentage># )
where 
<length-percentage> = <length> | <percentage>

Examples

This example demonstrates both types of values for the -ms-scroll-snap-points-y property. In the first selector, the first snap-point is at 0%, and the interval is set to 100%. In the second selector, each snap-point is listed separately — 100%, 200%, 300%, and so on. (The -ms-scroll-snap-points-y property behaves identically to the -ms-scroll-snap-points-x property, but along the y-axis.)

.container {
  overflow-x: auto;
  overflow-y: hidden;
  -ms-scroll-snap-type: mandatory;
  -ms-scroll-snap-points-y: snapInterval(0%, 100%);
  width: 480px;
  height: 270px;
}

.imageContainer {
  -ms-scroll-chaining: chained;
  -ms-overflow-style: none;
  -ms-content-zooming: zoom;
  -ms-scroll-rails: none;
  -ms-scroll-limit-y-min: 100%;
  -ms-scroll-limit-y-max: 500%;
  -ms-scroll-snap-type: proximity;
  -ms-scroll-snap-points-y: snapList(100%, 200%, 300%, 400%, 500%);
  -ms-overflow-style: none;
  width: 480px;
  height: 270px;
  overflow: auto;
}

Specifications

Not part of any specification.

Remarks

This property requires Windows 8 or later.

This property has no effect on non-scrollable elements.

Starting with Windows 8.1, this property is also supported for mouse, keyboard, and touchpad interaction.

See also

• scroll-snap-points-y The standard, but incompatible, similarly named property.