CSS scroll-margin-top 属性

定义和用法

scroll-margin-top 属性指定吸附位置与容器之间的距离。

吸附位置是指子元素在停止滚动时，其在容器中固定到位的位置。吸附位置通过 scroll-snap-align 属性设置，但也可能受到 CSS 属性 direction 和 writing-mode 的影响。

注意：此属性仅在吸附位置设置在子元素的顶部时才有效。

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

实例

例子 1

设置吸附位置与容器之间的顶部滚动外边距为 20px：

div {
  scroll-margin-top: 20px;
}

亲自试一试

例子 2：图片库

scroll-margin-top 属性可以在具有吸附行为的图片画廊中使用。在这里，scroll-margin-top 让用户知道顶部还有一张图片。滚动过第一张图片以查看效果：

#container > img {
  scroll-margin-top: 30px;
}

亲自试一试

例子 3：吸附位置

为了使 scroll-margin-top 属性生效，吸附位置必须设置在子元素的顶部。在这个例子中，writing-mode 属性将吸附位置从子元素的顶部改变到右侧。使用这样的代码，scroll-margin-top 属性将不再起作用：

#container {
  writing-mode: vertical-rl;
}

#container > div {
  scroll-margin-top: 30px;
  scroll-snap-align: start none;
}

亲自试一试

CSS 语法

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

属性值

技术细节

浏览器支持

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

相关页面

参考：CSS direction 属性

参考：CSS scroll-snap-align 属性

参考：CSS scroll-snap-type 属性

参考：CSS writing-mode 属性