CSS scroll-padding-block-start Property


Example

Set scroll padding in block direction to 20px from the start of the container to the snap position:

div {
  scroll-padding-block-start: 20px;
}
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The scroll-padding-block-start property specifies the distance in block direction from the start of the container to the snap position on the child elements.

This means that when you stop scrolling, the scrolling will quickly adjust and stop at a specified distance in block direction, between the snap position and the container.

Block direction is where the next line is put compared to the position of an existing line, and this is also how tags with CSS display: block; like <p> and <div> tags are laid out on a page. Block direction is dependent on the written language, i.e. Mongolian where new lines are laid out left to right which makes block direction left to right, while pages in English have a downward block direction. Block direction can be defined with CSS property writing-mode.

Snap position is the position on the child element where it snaps into place in the container when you stop scrolling.

Note: This property only works if the scroll-snap-align property is set to 'start' for the block direction.

To see the effect from the scroll-padding-block-start property, the scroll-snap-align property must be set on the child elements, and the scroll-padding-block-start and the 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.scrollPaddingBlockStart="20px" Try it

Browser Support

The numbers in the table specify the first browser version that fully supports the property.

Property
scroll-padding-block-start 69.0 79.0 68.0 15.0 56.0


CSS Syntax

scroll-padding-block-start: auto|value|initial|inherit;

Property Values

Value Description
auto Default value. The browser calculates the padding
length Specifies scroll-padding-block-start 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-block-start property can be used in an image gallery with snap behaviour, to push images below a fixed element:

#container {
  scroll-padding-block-start: 30px;
}
Fixed top element
alley bridge in jungle mountains man with camera Cinque Terre
Try it Yourself »

Example

With the writing-mode property value of the container element set to vertical-rl, the start of the container and child elements in block direction is moved from top to right side. This affects the scroll snap behaviour, and how the scroll-padding-block-start property works:

#container {
  scroll-padding-block-start: 20px;
  writing-mode: vertical-rl;
}
Try it Yourself »

Related Pages

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


Copyright 1999-2023 by Refsnes Data. All Rights Reserved.