CSS scroll-margin-block-start Property
Example
Set scroll margin to 20px between the snap position and the container in block direction:
div {
scroll-margin-block-start: 20px;
}
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The scroll-margin-block-start 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 at the start of the child element 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 CSS display: 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 property writing-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' for the block direction.
To see the effect from the scroll-margin-block-start property, the scroll-margin-block-start and scroll-snap-align properties must be set on the child elements, and the scroll-snap-type property must be set on the parent element.
The CSS
scroll-margin-inline and
scroll-margin-block properties are very similar to CSS properties
scroll-margin-top,
scroll-margin-bottom,
scroll-margin-left and
scroll-margin-right, but the
scroll-margin-block and
scroll-margin-inline properties are dependent on block and line directions.
| Default value: | 0 |
|---|---|
| Inherited: | no |
| Animatable: | no. Read about animatable |
| Version: | CSS3 |
| JavaScript syntax: | object.style.scrollMarginBlockStart="20px" Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| scroll-margin-block-start | 69.0 | 79.0 | 68.0 | 14.1 | 56.0 |
CSS Syntax
scroll-margin-block-start: 0|value|initial|inherit;
Property Values
| Value | Description |
|---|---|
| 0 | Default. The element's default scroll-margin distance. |
| 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 about initial |
| inherit | Inherits this property from its parent element. Read about inherit |
More Examples
Example
With the writing-mode property value of a <div> element set to vertical-rl, the block direction is right to left. The result is that the start of the element is moved from top to right side:
div {
scroll-margin-block-start: 50px;
writing-mode: vertical-rl;
}
Try it Yourself »
Related Pages
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