CSS scroll-margin-inline Property


Example

Set the distance to the scrollable container from a snap position in the inline direction:

div {
  scroll-margin-inline: 20px;
}
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The scroll-margin-inline property specifies the distance in the inline direction, between the snap position and the container.

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

Inline direction is where the next character is put compared to the position of the existing characters in a line, and this is also how tags with CSS display: inline; like <a> and <strong> tags are laid out in a text. Inline direction is dependent on the written language, i.e. Arabic where new charachters are laid out right to left which makes inline direction right to left, while pages in English have a left to right inline direction. Inline direction can be defined with CSS properties direction and writing-mode.

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

The scroll-margin-inline property is a shorthand property for the following properties:

Values for the scroll-margin-inline property can be set in different ways:

If the scroll-margin-inline property has two values:

  • scroll-margin-inline: 20px 70px;
    • distance at start is 20px
    • distance at end is 70px

If the scroll-margin-inline property has one value:

  • scroll-margin-inline: 20px;
    • distance at start and end is 20px

To see the effect from the scroll-margin-inline property, the scroll-margin-inline and scroll-snap-align properties must be set on the child elements, and the scroll-snap-type property must be set on the parent element.

The CSS scroll-margin-inline and scroll-margin-block properties are very similar to CSS properties scroll-margin-top, scroll-margin-bottom, scroll-margin-left and scroll-margin-right, but the scroll-margin-block and scroll-margin-inline properties are dependent on block and inline directions.

Default value: 0
Inherited: no
Animatable: no. Read about animatable
Version: CSS3
JavaScript syntax: object.style.scrollMarginInline="20px" Try it

Browser Support

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

Property
scroll-margin-inline 69.0 79.0 68.0 14.1 56.0


CSS Syntax

scroll-margin-inline: 0|value|initial|inherit;

Property Values

Value Description
0 Default. The element's default scroll-margin-inline distance.
length Specifies distance in px, pt, cm, etc. Negative values are allowed. Read about length units
initial Sets this property to its default value. Read about initial
inherit Inherits this property from its parent element. Read about inherit

More Examples

Example

With the writing-mode property value of a <div> element set to vertical-rl, the inline direction is downwards. The result is that the start of the element is moved from left side to top, and the end of the element is moved from right side to bottom. This also affects the scroll-margin-inline property:

div {
  scroll-margin-inline: 20px 0;
  writing-mode: vertical-rl;
}
Try it Yourself »

Example

With the direction property value of a <div> element set to rtl, the inline direction is right to left. The result is that the start of the element is moved from left side to right side, and the end of the element is moved from right side to left side. This also affects the scroll-margin-inline property:

div {
  scroll-margin-inline: 0 20px;
  direction: rtl;
}
Try it Yourself »

Related Pages

CSS direction property: CSS Direction property

CSS scroll-margin-inline-end property: CSS scroll-margin-inline-end property

CSS scroll-margin-inline-start property: CSS scroll-margin-inline-start 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


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