CSS scroll-margin-left 屬性

定義和用法

scroll-margin-left 屬性指定吸附位置與容器之間的距離。

吸附位置是指子元素在停止滾動時，其在容器中固定到位的位置。吸附位置通過 scroll-snap-align 屬性設置，但也可能受到 CSS 屬性 direction 和 writing-mode 的影響。

注意：此屬性僅在吸附位置設置在子元素的左側時才有效。

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

實例

例子 1

設置吸附位置與容器之間的滾動外邊距為 20px：

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

親自試一試

例子 2：圖片庫

scroll-margin-left 屬性可以在具有吸附行為的圖片畫廊中使用。在這里，scroll-margin-left 讓用戶知道左側還有一張圖片。滾動過第一張圖片以查看效果：

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

親自試一試

例子 3：吸附位置

為了使 scroll-margin-left 屬性生效，吸附位置必須設置在子元素的左側。在這個例中，direction 屬性將吸附位置從子元素的左側改變到右側。使用這樣的代碼，scroll-margin-left 屬性將不再起作用：

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

親自試一試

CSS 語法

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

屬性值

值 描述
0 滾動外邊距左側為 0。默認值。
length

以 px、pt、cm 等單位指定滾動外邊距左側的值。允許使用負值。

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

技術細節

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

瀏覽器支持

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

Chrome Edge Firefox Safari Opera
69.0 79.0 68.0 14.1 56.0

相關頁面

參考：CSS direction 屬性

參考：CSS scroll-snap-align 屬性

參考：CSS scroll-snap-type 屬性

參考：CSS writing-mode 屬性