CSSscroll-padding-top Property
Example
Set scroll padding to 20px from the top of the container to the snap position:
scroll-padding-top: 20px;
}
More "Try it Yourself" examples below.
Definition and Usage
Thescroll-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 withscroll-snap-align property, but can also be affected by CSS propertiesdirection andwriting-mode.
Note: This property only works if the snap position is placed at the top of the child element.
To see the effect from thescroll-padding-top property, thescroll-snap-align property must be set on the child elements, and thescroll-padding-top andscroll-snap-type properties must be set on the parent element.
| Default value: | auto |
|---|---|
| Inherited: | no |
| Animatable: | no.Read aboutanimatable |
| 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
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 aboutinitial |
| inherit | Inherits this property from its parent element.Read aboutinherit |
More Examples
Image gallery
Thescroll-padding-top property can be used in an image gallery with snap behaviour, to push images below a fixed element:
scroll-padding-top: 30px;
}
Set scroll-padding at the top
Thescroll-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:
scroll-padding-top: 30px;
}
Snap position
The snap position must be placed on top of the child elements for thescroll-padding-top property to work. In this example thewriting-mode property changes the snap position from top to the right side of child elements. With the code like this thescroll-padding-top property no longer works:
writing-mode: vertical-rl;
scroll-padding-top: 30px;
}
#container > div {
scroll-snap-align: start none;
}
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
