CSS scroll-padding-top Property
Example
Set scroll padding to 20px from the top of the container to the snap position:
div {
scroll-padding-top: 20px;
}
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The scroll-padding-top property specifies
the distance from the top of the container to the snap position on the child elements.
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 at the top of the child element.
To see the effect from the scroll-padding-top property, the scroll-snap-align property must be set on the child elements, and the scroll-padding-top and scroll-snap-type properties must be set on the parent element.
| Default value: | auto |
|---|---|
| Inherited: | no |
| Animatable: | no. Read about animatable |
| Version: | CSS3 |
| JavaScript syntax: | object.style.scrollPaddingTop="20px" Try it |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| scroll-padding-top | 69.0 | 79.0 | 68.0 | 14.1 | 56.0 |
CSS Syntax
scroll-padding-top: auto|value|initial|inherit;
Property Values
| Value | Description |
|---|---|
| auto | Default value. The browser calculates the padding |
| length | Specifies scroll-padding-top in px, pt, cm, etc. Negative values are not allowed. Read about length units |
| % | Specifies the padding in percent of the width of the containing element |
| 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-padding-top property can be used in an image gallery with snap behaviour, to push images below a fixed element:
#container {
scroll-padding-top: 30px;
}
Set scroll-padding at the top
The scroll-padding-top property can also be set on the container when snap behaviour is set in both directions. Scroll to the next element vertically to see the effect:
#container {
scroll-padding-top: 30px;
}
Snap position
The snap position must be placed on top of the child elements for the scroll-padding-top property to work. In this example the writing-mode property changes the snap position from top to the right side of child elements. With the code like this the scroll-padding-top property no longer works:
#container {
writing-mode: vertical-rl;
scroll-padding-top: 30px;
}
#container > div {
scroll-snap-align: start none;
}
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
