scroll-padding-block

The scroll-padding-block shorthand property sets the scroll padding of an element in the block dimension.

The scroll-padding properties define offsets for the optimal viewing region of the scrollport: the region used as the target region for placing things in view of the user. This allows the author to exclude regions of the scrollport that are obscured by other content (such as fixed-positioned toolbars or sidebars) or to put more breathing room between a targeted element and the edges of the scrollport.

Constituent properties

This property is a shorthand for the following CSS properties:

Syntax

/* Keyword values */
scroll-padding-block: auto;

/* <length> values */
scroll-padding-block: 10px;
scroll-padding-block: 1em .5em;
scroll-padding-block: 10%;

/* Global values */
scroll-padding-block: inherit;
scroll-padding-block: initial;
scroll-padding-block: unset;

Values

<length-percentage>
An inwards offset from the corresponding edge of the scrollport, as a valid length or a percentage.
auto
The offset is determined by the user agent. This will generally be 0px, but a user agent is able to detect and do something else if a non-zero value is more appropriate.

Formal definition

Initial valueauto
Applies toscroll containers
Inheritedno
Percentagesrelative to the scroll container's scrollport
Computed valueas specified
Animation typeby computed value type

Formal syntax

[ auto | <length-percentage> ]{1,2}

where
<length-percentage> = <length> | <percentage>

Specifications

Specification Status Comment
CSS Scroll Snap Module Level 1
The definition of 'scroll-padding-block' in that specification.
Candidate Recommendation Initial definition

Browser compatibility

BCD tables only load in the browser

See also