scroll-margin

在此页

组成特性
句法
描述
形式定义
形式句法
范例
规范
浏览器兼容性
相关话题

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.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

组成特性

此特性是下列 CSS 特性的简写：

句法

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

值

<length>

描述

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.

形式定义

初始值	`0`
适用于	所有元素
继承	no
计算值	如指定
动画类型	by computed value type

形式句法

<length>{1,4}

范例

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> ，和 2rems outside the left edge of the third <div> .

注意 : 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 ，或 scroll-margin: 0 0 0 1rem .

结果

Try it for yourself:

规范

规范	状态	注释
CSS Scroll Snap Module Level 1 The definition of 'scroll-margin' in that specification.	候选推荐	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`scroll-margin`	Chrome 完整支持 69	Edge 完整支持 79	Firefox 完整支持 68	IE 不支持 No	Opera 完整支持 56	Safari 部分支持 11 注意事项 Alternate Name 部分支持 11 注意事项 Alternate Name 注意事项 Scroll margin is not applied for scrolls to fragment target or `scrollIntoView()` ，见 bug 189265 . Alternate Name Uses the non-standard name: `scroll-snap-margin`	WebView Android 完整支持 69	Chrome Android 完整支持 69	Firefox Android 完整支持 68	Opera Android 完整支持 48	Safari iOS 部分支持 11 注意事项 Alternate Name 部分支持 11 注意事项 Alternate Name 注意事项 Scroll margin is not applied for scrolls to fragment target or `scrollIntoView()` ，见 bug 189265 . Alternate Name Uses the non-standard name: `scroll-snap-margin`	Samsung Internet Android 完整支持 10.0

图例

完整支持
部分支持
不支持
见实现注意事项。
使用非标名称。

元数据

最后修改： Aug 6, 2020

在此页