The CSS scroll-padding property
- previous page scroll-margin-top
- next page scroll-padding-block
Definition and Usage
scroll-padding
This property specifies the distance from the container to the吸附位置 of the child element.
This means that when you stop scrolling, the scroll will quickly adjust and stop at a specified distance from the container to the吸附位置 of the focus child element.
The吸附位置 refers to the fixed position of the child element in the container when it stops scrolling.
scroll-padding
This property is a shorthand for the following properties:
scroll-padding
The values of the property can be set in different ways:
If the scroll-padding property has four values:
scroll-padding: 15px 30px 60px 90px;
- The top distance is 15px
- The right distance is 30px
- The bottom distance is 60px
- The left distance is 90px
If the scroll-padding property has three values:
scroll-padding: 15px 30px 60px;
- The top distance is 15px
- The distance to the left and right is 30px
- The bottom distance is 60px
If the scroll-padding property has two values:
scroll-padding: 15px 30px;
- The top and bottom distances are 15px
- The distance to the left and right is 30px
If the scroll-padding property has a value:
scroll-padding: 10px;
- All four directions are 10px apart
to see scroll-padding
property on the parent element, the effect must be set on the child element to see scroll-snap-align
property, and set scroll-padding
and scroll-snap-type
property.
Note:In the following example, scroll padding is set for all sides, but due to scroll-snap-align
Set to "start" so that only the top edge's scroll padding changes the scrolling behavior.
Instance
Example 1
Set the scroll padding from the container to the sticky position to 20px:
div { scroll-padding: 20px; }
Example 2: Image library
scroll-padding
The property can be used in galleries with sticky behavior to push images below the fixed element:
#container { scroll-padding: 30px 0 0 0; }





Example 3: Set scroll padding at the bottom and right
scroll-padding
The property can be set at the bottom and right of the container at the same time. Scroll horizontally and vertically to the next element to see the effect:
#container { scroll-padding: 0 10px 30px 0; }
CSS syntax
scroll-padding: auto|value|initial|inherit;
Attribute value
Value | Description |
---|---|
auto | Default value. The browser calculates the padding. |
length |
Specify scroll padding in units such as px, pt, cm, etc. Negative values are not allowed. See:CSS Units. |
% | Specifies the padding percentage relative to the width of the containing element. |
initial | Sets this property to its default value. See initial. |
inherit | Inherits this property from its parent element. See inherit. |
Technical details
Default value: | auto |
---|---|
Inheritance: | No |
Animation creation: | Not supported. See:Animation-related properties. |
Version: | CSS3 |
JavaScript syntax: | object.style.scrollPadding="20px" |
Browser support
The numbers in the table represent the first browser version to fully support this property.
Chrome | Edge | Firefox | Safari | Opera |
---|---|---|---|---|
69.0 | 79.0 | 68.0 | 14.1 | 56.0 |
Related pages
Reference:The CSS scroll-padding-bottom property
Reference:The CSS scroll-padding-left property
Reference:The CSS scroll-padding-right property
Reference:The CSS scroll-padding-top property
Reference:The CSS scroll-snap-align property
Reference:The CSS scroll-snap-type property
- previous page scroll-margin-top
- next page scroll-padding-block