CSS scroll-padding-inline 属性

定义和用法

scroll-padding-inline 属性指定在行内方向上,从容器到子元素吸附位置的距离。

这意味着当你停止滚动时,滚动将快速调整并停止在吸附位置与容器之间指定的距离处。

行内方向是指相对于一行中现有字符的位置,下一个字符被放置的方向。这也是具有 CSS display: inline; 的标签(如 <a> 和 <strong> 标签)在文本中的布局方式。行内方向取决于书写语言,例如阿拉伯语的新字符从右到左排列,使得行内方向为从右到左,而英语页面则具有从左到右的行内方向。行内方向可以通过 CSS 属性 directionwriting-mode 来定义。

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

注意:此属性仅在行内方向上,scroll-snap-align 属性设置为 'start' 或 'end' 时才有效。

scroll-padding-inline 属性是以下属性的简写属性:

scroll-padding-inline 属性的值可以通过不同方式设置:

如果 scroll-padding-inline 属性有两个值:

scroll-padding-inline: 10px 50px;
  • 开始处的距离为 10px
  • 结束处的距离为 50px

如果 scroll-padding-inline 属性有一个值:

scroll-padding-inline: 10px;
  • 开始处和结束处的距离均为 10px

要看到 scroll-padding-inline 属性的效果,必须在子元素上设置 scroll-snap-align 属性,并在父元素上设置 scroll-padding-inlinescroll-snap-type 属性。

CSS 的 scroll-padding-blockscroll-padding-inline 属性与 CSS 属性 CSS scroll-padding-top 属性scroll-padding-bottomscroll-padding-leftscroll-padding-right 非常相似,但 scroll-padding-blockscroll-padding-inline 属性依赖于块方向和行内方向。

实例

例子 1

设置行内方向上的滚动内边距,从容器到吸附位置为 20px:

div {
  scroll-padding-inline: 20px;
}

亲自试一试

例子 2:图片库

在具有吸附行为的图片画廊中,可以使用 scroll-padding-inline 属性将图片从固定元素后面推出:

#container {
  scroll-padding-inline: 30px 0;
}

亲自试一试

例子 3

当容器元素的 writing-mode 属性值设置为 'vertical-rl' 时,行内方向上的容器和子元素的起始位置从左侧移动到顶部,结束位置从右侧移动到底部。这会影响滚动吸附行为以及 scroll-padding-inline 属性的工作方式:

#container {
  scroll-padding-inline: 20px 0;
  writing-mode: vertical-rl;
}

亲自试一试

例子 4

当容器元素的 direction 属性值设置为 'rtl' 时,行内方向上的容器和子元素的起始位置从右侧移动到左侧。这会影响滚动吸附行为以及 scroll-padding-inline 属性的工作方式:

#container {
  scroll-padding-inline: 20px 0;
  direction: rtl;
}

亲自试一试

CSS 语法

scroll-padding-inline: auto|value|initial|inherit;

属性值

描述
auto 默认值。浏览器计算内边距。
length

以 px、pt、cm 等单位指定 scroll-padding-inline。

不允许使用负值。请参阅:CSS 单位

% 以包含元素宽度的百分比指定内边距。
initial 将此属性设置为其默认值。参阅 initial
inherit 从其父元素继承此属性。参阅 inherit

技术细节

默认值: auto
继承性:
动画制作: 不支持。请参阅:动画相关属性
版本: CSS3
JavaScript 语法: object.style.scrollPaddingInline="20px"

浏览器支持

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

Chrome Edge Firefox Safari Opera
69.0 79.0 68.0 15.0 56.0

相关页面

参考:CSS direction 属性

参考:CSS scroll-snap-align 属性

参考:CSS scroll-snap-type 属性

参考:CSS writing-mode 属性