CSSscroll-margin-block Property
Example
Set the distance to the scrollable container from a snap position in the block direction:
scroll-margin-block: 10px;
}
More "Try it Yourself" examples below.
Definition and Usage
Thescroll-margin-block property specifies the distance in block direction, between the snap position and the container.
This means that when you stop scrolling, the scrolling will quickly adjust and stop at a specified distance in block direction, between the snap position and the container.
Block direction is where the next line is put compared to the position of an existing line, and this is also how tags with CSSdisplay: block; like <p> and <div> tags are laid out on a page. Block direction is dependent on the written language, i.e. Mongolian where new lines are laid out left to right which makes block direction left to right, while pages in English have a downward block direction. Block direction can be defined with CSS propertywriting-mode.
Snap position is the position on the child element where it snaps into place in the container when you stop scrolling.
Note: This property only works if the scroll-snap-align property is set to 'start' or 'end' for the block direction.
Thescroll-margin-block property is a shorthand property for the following properties:
Values for thescroll-margin-block property can be set in different ways:
If the scroll-margin-block property has two values:
- scroll-margin-block: 10px 50px;
- distance at start is 10px
- distance at end is 50px
If the scroll-margin-block property has one value:
- scroll-margin-block: 10px;
- distance at start and end is 10px
To see the effect from thescroll-margin-block property, thescroll-margin-block andscroll-snap-align properties must be set on the child elements, and thescroll-snap-type property must be set on the parent element.
The CSSscroll-margin-inline andscroll-margin-block properties are very similar to CSS propertiesscroll-margin-top,scroll-margin-bottom,scroll-margin-left andscroll-margin-right, but thescroll-margin-block andscroll-margin-inline properties are dependent on block and inline directions.
| Default value: | 0 |
|---|---|
| Inherited: | no |
| Animatable: | no.Read aboutanimatable |
| Version: | CSS3 |
| JavaScript syntax: | object.style.scrollMarginBlock="20px"Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| scroll-margin-block | 69.0 | 79.0 | 68.0 | 14.1 | 56.0 |
CSS Syntax
Property Values
| Value | Description |
|---|---|
| 0 | Default. The element's default scroll-margin-block value. |
| length | Specifies distance in px, pt, cm, etc. Negative values are allowed.Read about length units |
| initial | Sets this property to its default value.Read aboutinitial |
| inherit | Inherits this property from its parent element.Read aboutinherit |
More Examples
Example
With thewriting-mode property value of a child element set to vertical-rl, the start of the element in block direction is moved from top to right side, and the end of the element is moved from bottom to left side. This affects the scroll snap behaviour, and how the scroll-margin-block property works:
scroll-margin-block: 20px 0;
writing-mode: vertical-rl;
}
Related Pages
CSS scroll-margin-block-end property:CSS scroll-margin-block-end property
CSS scroll-margin-block-start property:CSS scroll-margin-block-start property
CSS scroll-snap-align property:CSS Scroll-snap-align property
CSS scroll-snap-type property:CSS Scroll-snap-type property
CSS writing-mode property:CSS Writing-mode property
