CSS scroll-margin-inline 屬性

定義和用法

scroll-margin-inline 屬性指定在行內方向上,吸附位置與容器之間的距離。

這意味著,當你停止滾動時,滾動會快速調整并在行內方向上停在指定的距離處,該距離位于吸附位置與容器之間。

行內方向是指下一字符相對于現有字符在行中的位置放置的方向,這也是具有 CSS display: inline; 的標簽(如 <a> 和 <strong> 標簽)在文本中的布局方式。行內方向取決于書寫語言,例如阿拉伯語的新字符是從右到左排列的,因此行內方向是從右到左的,而英文頁面的行內方向是從左到右的。行內方向可以通過 CSS 屬性 directionwriting-mode 定義。

吸附位置是指子元素在停止滾動時吸附到容器中的位置。

scroll-margin-inline 屬性是以下屬性的簡寫屬性:

scroll-margin-inline 屬性的值可以通過不同方式設置:

如果 scroll-margin-inline 屬性有兩個值:

scroll-margin-inline: 20px 70px;
  • 開始處的距離為 20px
  • 結束處的距離為 70px

如果 scroll-margin-inline 屬性有一個值:

scroll-margin-inline: 20px;
  • 開始處和結束處的距離均為 20px

要看到 scroll-margin-inline 屬性的效果,必須在子元素上設置 scroll-margin-inlinescroll-snap-align 屬性,并在父元素上設置 scroll-snap-type 屬性。

CSS 的 scroll-margin-inlinescroll-margin-block 屬性與 CSS 屬性 CSS scroll-margin-top 屬性scroll-margin-bottomscroll-margin-leftscroll-margin-right 非常相似,但 scroll-margin-blockscroll-margin-inline 屬性依賴于塊方向和行內方向。

實例

例子 1

設置在行內方向上,從吸附位置到可滾動容器的距離:

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

親自試一試

例子 2

當 <div> 元素的 writing-mode 屬性值設置為 vertical-rl 時,行內方向是向下。結果是元素的起始位置從左側移動到頂部,元素的結束位置從右側移動到底部。這也影響了 scroll-margin-inline 屬性:

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

親自試一試

例子 3

當 <div> 元素的 direction 屬性值設置為 rtl 時,行內方向是從右到左。結果是元素的起始位置從左側移動到右側,元素的結束位置從右側移動到左側。這也影響了 scroll-margin-inline 屬性:

div {
  scroll-margin-inline: 0 20px;
  direction: rtl;
}

親自試一試

CSS 語法

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

屬性值

描述
0 默認。元素的默認 scroll-margin-inline 距離。
length

指定以 px、pt、cm 等單位的距離。允許使用負值。

請參閱:CSS 單位

initial 將此屬性設置為其默認值。參閱 initial
inherit 從其父元素繼承此屬性。參閱 inherit

技術細節

默認值: 0
繼承性:
動畫制作: 不支持。請參閱:動畫相關屬性
版本: CSS3
JavaScript 語法: object.style.scrollMarginInline="20px"

瀏覽器支持

表格中的數字表示首個完全支持該屬性的瀏覽器版本。

Chrome Edge Firefox Safari Opera
69.0 79.0 68.0 14.1 56.0

相關頁面

參考:CSS direction 屬性

參考:CSS scroll-margin-inline-end 屬性

參考:CSS scroll-margin-inline-start 屬性

參考:CSS scroll-snap-align 屬性

參考:CSS scroll-snap-type 屬性

參考:CSS writing-mode 屬性