CSS scroll-margin-block 屬性

定義和用法

scroll-margin-block 屬性指定在塊方向上，吸附位置（snap position）與容器之間的距離。

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

塊方向是指相對于現有行位置放置下一行的方向，這也是具有 CSS display: block; 的標簽（如 <p> 和 <div> 標簽）在頁面上的布局方式。塊方向取決于書寫語言，例如，蒙古語的新行從左到右排列，因此塊方向也是從左到右，而英文頁面的塊方向是向下。塊方向可以通過 CSS 屬性 writing-mode 來定義。

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

注意：此屬性僅在塊方向的 scroll-snap-align 屬性設置為 'start' 或 'end' 時有效。

• scroll-margin-block-start
• scroll-margin-block-end

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

如果 scroll-margin-block 屬性有兩個值：

scroll-margin-block: 10px 50px;

• 開始處的距離為 10px
• 結束處的距離為 50px

如果 scroll-margin-block 屬性有一個值：

scroll-margin-block: 10px;

• 開始處和結束處的距離均為 10px

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

CSS 的 scroll-margin-inline 和 scroll-margin-block 屬性與 CSS 屬性 CSS scroll-margin-top 屬性、scroll-margin-bottom、scroll-margin-left 和 scroll-margin-right 非常相似，但 scroll-margin-block 和 scroll-margin-inline 屬性依賴于塊方向和行內方向。

實例

例子 1

設置塊方向上吸附位置與可滾動容器之間的距離：

div {
  scroll-margin-block: 10px;
}

親自試一試

例子 2

當子元素的 writing-mode 屬性值設置為 vertical-rl 時，元素在塊方向的起始位置從頂部移動到右側，結束位置從底部移動到左側。這會影響滾動吸附行為以及 scroll-margin-block 屬性的工作方式：

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

親自試一試

CSS 語法

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

屬性值

技術細節

瀏覽器支持

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

相關頁面

參考：CSS scroll-margin-block-end 屬性

參考：CSS scroll-margin-block-start 屬性

參考：CSS scroll-snap-align 屬性

參考：CSS scroll-snap-type 屬性

參考：CSS writing-mode 屬性