scroll-margin
Quick Summary for scroll-margin
The scroll-margin shorthand property sets all of the scroll margins of an element at once, assigning values much like the margin property does for margins of an element.
Code Usage for scroll-margin
/* <length> values */ scroll-margin: 10px; scroll-margin: 1em .5em 1em 1em;  /* Global values */ scroll-margin: inherit; scroll-margin: initial; scroll-margin: revert; scroll-margin: unset; 
More Details for scroll-margin

scroll-margin

The scroll-margin shorthand property sets all of the scroll margins of an element at once, assigning values much like the margin property does for margins of an element.

Constituent properties

This property is a shorthand for the following CSS properties:

scroll-margin-bottom scroll-margin-left scroll-margin-right scroll-margin-top

Syntax

/* <length> values */ scroll-margin: 10px; scroll-margin: 1em .5em 1em 1em;  /* Global values */ scroll-margin: inherit; scroll-margin: initial; scroll-margin: revert; scroll-margin: unset; 

Values

<length>

An outset from the corresponding edge of the scroll container.

Description

You can see the effect of scroll-margin by scrolling to a point partway between two of the "pages" of the example's content. The value specified for scroll-margin determines how much of the page that's primarily outside the snapport should remain visible.

Thus, the scroll-margin values represent outsets defining the scroll snap area that is used for snapping this box to the snapport. The scroll snap area is determined by taking the transformed border box, finding its rectangular bounding box (axis-aligned in the scroll container's coordinate space), then adding the specified outsets.

Formal definition

Initial value0
Applies toall elements
Inheritedno
Computed valueas specified
Animation typeby computed value type

Formal syntax

<length>{1,4}

Examples

Simple demonstration

This example implements something very similar to the interactive example above, except that here we'll explain to you how it's implemented.

The aim here is to create four horizontally-scrolling blocks, the second and third of which snap into place, near but not quite at the left of each block.

HTML

The HTML that represents the blocks is very simple:

<div class="scroller">   <div>1</div>   <div>2</div>   <div>3</div>   <div>4</div> </div> 
CSS

Let's walk through the CSS. the outer container is styled like this:

.scroller {   text-align: left;   width: 250px;   height: 250px;   overflow-x: scroll;   display: flex;   box-sizing: border-box;   border: 1px solid #000;   scroll-snap-type: x mandatory; } 

The main parts relevant to the scroll snapping are overflow-x: scroll, which makes sure the contents will scroll and not be hidden, and scroll-snap-type: x mandatory, which dictates that scroll snapping must occur along the horizontal axis, and the scrolling will always come to rest on a snap point.

The child elements are styled as follows:

.scroller > div {   flex: 0 0 250px;   width: 250px;   background-color: #663399;   color: #fff;   font-size: 30px;   display: flex;   align-items: center;   justify-content: center;   scroll-snap-align: start; }  .scroller > div:nth-child(2n) {   background-color: #fff;   color: #663399; } 

The most relevant part here is scroll-snap-align: start, which specifies that the left-hand edges (the "starts" along the x axis, in our case) are the designated snap points.

Last of all we specify the scroll margin-values, a different one for the second and third child elements:

.scroller > div:nth-child(2) {   scroll-margin: 1rem; }  .scroller > div:nth-child(3) {   scroll-margin: 2rem; } 

This means that when scrolling past the middle child elements, the scrolling will snap to 1rem outside the left edge of the second <div>, and 2rems outside the left edge of the third <div>.

Note: Here we are setting scroll-margin on all sides at once, but only the start edge is really relevant. It would work just as well here to only set a scroll margin on that one edge, for example with scroll-margin-inline-start: 1rem, or scroll-margin: 0 0 0 1rem.

Result

Try it for yourself:

Specifications

Specification
CSS Scroll Snap Module Level 1 # scroll-margin

See also

CSS Scroll Snap Well-Controlled Scrolling with CSS Scroll Snap Select your preferred language English (US)Français日本語中文 (简体) Change language

No Items Found.

Add Comment
Type in a Nick Name here
 
Other Categories in CSS
css
Search CSS
Search CSS by entering your search text above.
Welcome

This is my test area for webdev. I keep a collection of code here, mostly for my reference. Also if i find a good link, i usually add it here and then forget about it. more...

Subscribe to weekly updates about things i have added to the site or thought interesting during the last week.

You could also follow me on twitter or not... does anyone even use twitter anymore?

If you found something useful or like my work, you can buy me a coffee here. Mmm Coffee. ☕

❤️👩‍💻🎮

🪦 2000 - 16 Oct 2022 - Boots
Random Quote
I believe that in order to better your knowledge base, it takes a lot of failing in order to succeed. I don't consider anything a failure as long as you get back up and you learn from your own mistakes.
Unknown
Random CSS Property

border-left-width

The border-left-width CSS property sets the width of the left border of an element.
border-left-width css reference