CSS scroll-margin-left Property
Example
Set scroll margin to 20px between the snap position and the container:
div {
scroll-margin-left: 20px;
}
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The scroll-margin-left property specifies
the distance between the snap position and the container.
Snap position is the position on the child element where it snaps into place in the container when you stop scrolling. Snap position is set with scroll-snap-align property, but can also be affected by CSS properties direction and writing-mode.
Note: This property only works if the snap position is placed on the left side of the child element.
To see the effect from the scroll-margin-left property, the scroll-margin-left 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.
| Default value: | 0 |
|---|---|
| Inherited: | no |
| Animatable: | no. Read about animatable |
| Version: | CSS3 |
| JavaScript syntax: | object.style.scrollMarginLeft="20px" Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| scroll-margin-left | 69.0 | 79.0 | 68.0 | 14.1 | 56.0 |
CSS Syntax
scroll-margin-left: 0|value|initial|inherit;
Property Values
| Value | Description |
|---|---|
| 0 | Scroll-margin-left is zero. This is default |
| length | Specifies scroll-margin-left 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
Image gallery
The scroll-margin-left property can be used in an image gallery with snap behaviour. Here, the scroll-margin-left lets the user see that there is an image to the left. Scroll past the first image to see the effect:
#container > img {
scroll-margin-left: 30px;
}
Snap position
The snap position must be placed on the left side of the child elements for the scroll-margin-left property to work. In this example the direction property changes the snap position from left to right side of child elements. With the code like this the scroll-margin-left property no longer works:
#container {
direction: rtl;
}
#container > div {
scroll-margin-left: 30px;
scroll-snap-align: none start;
}
Try it Yourself »
Related Pages
CSS direction property: CSS Direction 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
