CSS scroll-padding-inline 属性
定义和用法
scroll-padding-inline 属性指定在行内方向上,从容器到子元素吸附位置的距离。
这意味着当你停止滚动时,滚动将快速调整并停止在吸附位置与容器之间指定的距离处。
行内方向是指相对于一行中现有字符的位置,下一个字符被放置的方向。这也是具有 CSS display: inline; 的标签(如 <a> 和 <strong> 标签)在文本中的布局方式。行内方向取决于书写语言,例如阿拉伯语的新字符从右到左排列,使得行内方向为从右到左,而英语页面则具有从左到右的行内方向。行内方向可以通过 CSS 属性 direction 和 writing-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-inline 和 scroll-snap-type 属性。
CSS 的 scroll-padding-block 和 scroll-padding-inline 属性与 CSS 属性 CSS scroll-padding-top 属性、scroll-padding-bottom、scroll-padding-left 和 scroll-padding-right 非常相似,但 scroll-padding-block 和 scroll-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 |