CSS scroll-margin-block 属性

定义和用法

scroll-margin-block 属性指定在块方向上，吸附位置（snap position）与容器之间的距离。

这意味着当您停止滚动时，滚动会快速调整并停止在块方向上吸附位置与容器之间的指定距离处。

块方向是指相对于现有行位置放置下一行的方向，这也是具有 CSS display: block; 的标签（如 <p> 和 <div> 标签）在页面上的布局方式。块方向取决于书写语言，例如，蒙古语的新行从左到右排列，因此块方向也是从左到右，而英文页面的块方向是向下。块方向可以通过 CSS 属性 writing-mode 来定义。

吸附位置是指当你停止滚动时，子元素在容器中吸附到位的位置。

注意：此属性仅在块方向的 scroll-snap-align 属性设置为 'start' 或 'end' 时有效。

• scroll-margin-block-start
• scroll-margin-block-end

scroll-margin-block 属性的值可以通过不同方式设置：

如果 scroll-margin-block 属性有两个值：

scroll-margin-block: 10px 50px;

• 开始处的距离为 10px
• 结束处的距离为 50px

如果 scroll-margin-block 属性有一个值：

scroll-margin-block: 10px;

• 开始处和结束处的距离均为 10px

要看到 scroll-margin-block 属性的效果，必须在子元素上设置 scroll-margin-block 和 scroll-snap-align 属性，并在父元素上设置 scroll-snap-type 属性。

CSS 的 scroll-margin-inline 和 scroll-margin-block 属性与 CSS 属性 CSS scroll-margin-top 属性、scroll-margin-bottom、scroll-margin-left 和 scroll-margin-right 非常相似，但 scroll-margin-block 和 scroll-margin-inline 属性依赖于块方向和行内方向。

实例

例子 1

设置块方向上吸附位置与可滚动容器之间的距离：

div {
  scroll-margin-block: 10px;
}

亲自试一试

例子 2

当子元素的 writing-mode 属性值设置为 vertical-rl 时，元素在块方向的起始位置从顶部移动到右侧，结束位置从底部移动到左侧。这会影响滚动吸附行为以及 scroll-margin-block 属性的工作方式：

div {
  scroll-margin-block: 20px 0;
  writing-mode: vertical-rl;
}

亲自试一试

CSS 语法

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

属性值

技术细节

浏览器支持

表格中的数字表示首个完全支持该属性的浏览器版本。

相关页面

参考：CSS scroll-margin-block-end 属性

参考：CSS scroll-margin-block-start 属性

参考：CSS scroll-snap-align 属性

参考：CSS scroll-snap-type 属性

参考：CSS writing-mode 属性