scroll-margin-block

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

scroll-margin-block は一括指定プロパティで、ブロック方向のスクロールマージンを設定します。

試してみましょう

scroll-margin-block: 0;

scroll-margin-block: 20px;

scroll-margin-block: 2em;

<section class="default-example" id="default-example">
  <div class="scroller">
    <div>1</div>
    <div id="example-element">2</div>
    <div>3</div>
  </div>
  <div class="info">Scroll »</div>
</section>

.default-example .info {
  inline-size: 100%;
  padding: 0.5em 0;
  font-size: 90%;
  writing-mode: vertical-rl;
}

.scroller {
  text-align: left;
  height: 250px;
  width: 270px;
  overflow-y: scroll;
  display: flex;
  flex-direction: column;
  box-sizing: border-box;
  border: 1px solid black;
  scroll-snap-type: y mandatory;
}

.scroller > div {
  flex: 0 0 250px;
  background-color: rebeccapurple;
  color: #fff;
  font-size: 30px;
  display: flex;
  align-items: center;
  justify-content: center;
  scroll-snap-align: start;
}

.scroller > div:nth-child(even) {
  background-color: #fff;
  color: rebeccapurple;
}

構成要素のプロパティ

このプロパティは以下の CSS プロパティの一括指定です。

構文

css

/* <length> 値 */
scroll-margin-block: 10px;
scroll-margin-block: 1em 0.5em;

/* グローバル値 */
scroll-margin-block: inherit;
scroll-margin-block: initial;
scroll-margin-block: revert;
scroll-margin-block: unset;

値

<length>: スクロールコンテナーの対応する辺からの距離です。

解説

scroll-margin の値はこのボックスをスナップポートに割り当てるために使用されるスクロールスナップ領域の定義の張り出し部分を表します。スクロールスナップ領域は、変換された境界ボックスを取り、その矩形の境界ボックス (スクロールコンテナーの座標空間内で軸方向に配置) を割り当てて、指定された張り出し部分を追加することによって決定されます。

公式定義

初期値	一括指定の次の各プロパティとして `scroll-margin-block-start`: `0` `scroll-margin-block-end`: `0`
適用対象	すべての要素
継承	なし
計算値	一括指定の次の各プロパティとして `scroll-margin-block-start`: 指定通り `scroll-margin-block-end`: 指定通り
アニメーションの種類	計算値の型による

形式文法

scroll-margin-block = 
  <length>{1,2}

仕様書

Specification
CSS Scroll Snap Module Level 1 # propdef-scroll-margin-block