Sifat scroll-margin-block CSS

Definisi dan penggunaan

scroll-margin-block Atribut menentukan jarak di antara tempat penarik (snap position) dan kontainer dalam arah blok.

Ini bermakna ketika Anda berhenti menggulir, penarikan akan menyesuaikan dan berhenti di tempat penarik arah blok dengan jarak yang ditentukan di antara kontainer.

Arah blok adalah arah penempatan baris berikutnya berbanding dengan posisi baris sedia ada, ini juga cara penempatan tag yang mempunyai CSS display: block; seperti tag <p> dan <div> di halaman. Arah blok tergantung kepada bahasa tulisan, contohnya, baris baru dalam bahasa Mongolia diatur dari kiri ke kanan, jadi arah blok juga dari kiri ke kanan, sementara arah blok halaman Inggeris adalah ke bawah. Arah blok dapat diatur melalui atribut CSS writing-mode didefinisikan.

Lokasi penarik adalah lokasi di mana elemen anak diikat ke tempat di dalam kontainer apabila Anda berhenti menggulir.

Perhatian:Atribut ini hanya berlaku dalam arah blok: scroll-snap-align Atribut ini berlaku apabila diatur kepada 'start' atau 'end'.

scroll-margin-block Atribut adalah singkatan untuk atribut berikut:

scroll-margin-block Nilai atribut dapat diatur dengan cara berbeza:

Jika atribut scroll-margin-block mempunyai dua nilai:

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

如果 scroll-margin-block 属性有一个值:

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

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

CSS 的 scroll-margin-inlinescroll-margin-block 属性与 CSS 属性 Sifat scroll-margin-top CSSscroll-margin-bottomscroll-margin-leftscroll-margin-right 非常相似,但 scroll-margin-blockscroll-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;

属性值

描述
0 默认。元素的默认 scroll-margin-block 值。
length

指定以 px、pt、cm 等为单位的距离。允许负值。

请参阅:Unit CSS

initial 将此属性设置为其默认值。参阅 initial
inherit 从其父元素继承此属性。参阅 inherit

技术细节

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

浏览器支持

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

Chrome Edge Firefox Safari Opera
69.0 79.0 68.0 14.1 56.0

Halaman berkaitan

Rujukan:Sifat scroll-margin-block-end CSS

Rujukan:Sifat scroll-margin-block-start CSS

Rujukan:Sifat scroll-snap-align CSS

Rujukan:Sifat scroll-snap-type CSS

Rujukan:属性 writing-mode CSS