CSSでモーダルの後ろのページをスクロールさせない方法

​​CSS​HTML,Playwright

モーダルを開いているのに、背景のページまでスクロールしてしまうことがあります。利用規約やチャットのモーダルで、中のリストを最後まで読んだとたんに後ろのページが動き出す動き(スクロール連鎖)は、リストに overscroll-behavior: contain を付けると止まります。JavaScript でイベントを止める必要はありません。ただし、効くのは付けた要素の上で操作したときだけです。モーダルの外側の背景の上でホイールを回すと、後ろのページは動きます。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。showModal() で開いた <dialog> の上で、マウスのホイール、キーボード、タッチ(Chrome DevTools Protocol のタッチイベント)の操作を再現し、後ろのページの scrollY と中のリストの scrollTop を読みました。Firefox と Safari、スマートフォンの実機、トラックパッドでの操作、端で跳ね返る表示や「引っ張って更新」の動きは試していません。

モーダルの中のリストの上でホイールを4回回す様子を2回続けて映した動画。1回目は overscroll-behavior の指定なしで、リストが最後まで動いたあとの4回目に、後ろのページの scrollY が 0px から 300px に変わり、ピンクで表示される。2回目は .dialog-body に overscroll-behavior: contain を付けていて、4回目も後ろのページは 0px のまま
モーダルの中のリストの上でホイールを回したとき、後ろのページが動くかどうか。録画では画面に収めるためリストの高さを200pxにしていて、下に着く位置は700px。上の帯、カーソルの丸、下の数字の表示は録画のために足したもの

中のリストに contain を付ける

検証に使ったモーダルは、見出し、スクロールするリスト、閉じるボタンを持つ <dialog> です。後ろのページは、段落を40個並べて縦に長くしてあります。

html
<dialog id="dlg">
  <h2>利用規約</h2>
  <ul class="dialog-body">
    <li>第1条</li>
    <!-- 第20条まで -->
  </ul>
  <form method="dialog"><button>閉じる</button></form>
</dialog>

リストの高さを決めてスクロールさせ、そこに overscroll-behavior: contain を付けます。

css
.dialog-body {
  max-height: 240px;
  overflow-y: auto;
  overscroll-behavior: contain;
}

showModal() で開き、リストの上でホイールを300pxずつ5回回したときの値は次のとおりです。リストは中身が900px、見えている高さが240pxなので、660pxでいちばん下に着きます。

回数 指定なし:ページ 指定なし:リスト contain:ページ contain:リスト
1回目 0 300 0 300
2回目 0 600 0 600
3回目 0 660 0 660
4回目 300 660 0 660
5回目 600 660 0 660

指定なしのときは、リストが下に着いたあとの4回目から、後ろのページが動き出しました。3回目でリストが60pxしか動けなかったとき、残りの240pxはページに回りませんでした。contain を付けると、5回目まで後ろのページは0pxのままでした。

MDN の overscroll-behavior のページは、ダイアログのスクロール境界に達したあと下のページがスクロールを始める動きを「スクロール連鎖」と呼び、このプロパティでそれを抑止できると説明しています。値の1つ目は横(x)、2つ目は縦(y)の指定で、1つだけ書くと両方に同じ値が入ります。縦だけで十分なら overscroll-behavior-y: contain でもよく、検証環境では contain と同じ結果でした。

キーボードとタッチでも止まる

ホイールのほかに、リストにフォーカスを置いて PageDown キーを6回押す操作と、指を上へ300px動かして離す操作も試しました。

操作 指定なし contain
PageDown キー リストが660pxに着いたあと、ページが612px、1224pxと動いた ページは0pxのまま
指で上へ300pxを4回 4回目にページが285px動いた ページは0pxのまま

CSS Overscroll Behavior の仕様には、このプロパティはブラウザーが持つすべてのスクロールの方法に適用する、と書かれています。

none にしても、ホイールの結果は contain と同じでした。仕様では、none は contain の動きに加えて、端で跳ね返るような表示(overscroll affordance)も出さない値です。後ろへ伝えないことだけが目的なら、contain で足ります。

リストの外の操作は、リストの contain では止まらない

.dialog-body に contain を付けただけのとき、リストの外でホイールを回すと、後ろのページが動きました。

ホイールを回した場所 .dialog-body に contain dialog にも contain
モーダルの見出し 300px、600pxと動いた 0pxのまま
モーダルの外側の背景(::backdrop) 300px、600pxと動いた 300px、600pxと動いた

見出しの上の操作は、dialog 自身に overscroll-behavior: contain を付けると止まりました。Chromium 153 では、showModal() で開いた <dialog> の overflow の計算値が auto で、dialog もスクロールコンテナーになっているためです。dialog { overflow: visible; } にしてから contain を付けると、見出しの上で回したホイールでページが動きました。仕様にも、スクロールコンテナーでない要素では値を受け付けるが無視する、とあります。

背景の上のホイールは、dialog に付けても止まりませんでした。

背景の上も止めるなら、開いている間だけ html の overflow を hidden にする

背景の上の操作まで止めるには、モーダルが開いているあいだ、ページ全体のスクロールを止めます。:modal 擬似クラスは showModal() で開いたダイアログに一致するので、:has() と組み合わせると、クラスを付け外しする JavaScript を書かずに済みます。

css
html:has(dialog:modal) {
  overflow: hidden;
}

.dialog-body に contain を付けたうえで、背景の上を操作した結果は次のとおりです。

背景の上の操作 結果
ホイール(html:has(dialog:modal) { overflow: hidden }) ページは0pxのまま
ホイール(body:has(dialog:modal) { overflow: hidden }) ページは0pxのまま
ホイール(html:has(dialog:modal) { overscroll-behavior: contain }) 300px、600pxと動いた
指で上へ300px(html:has(dialog:modal) { overflow: hidden }) ページは0pxのまま

overflow: hidden にしても、中のリストはホイールで300px動きました。閉じると html の overflow は visible に戻りました。html に overscroll-behavior: contain を付けた場合は、背景の上のホイールでページが動きました。

html の overflow: hidden だけを書き、overscroll-behavior を付けない場合も試しました。リスト、見出し、背景の上のホイール、リストにフォーカスしての PageDown キー、リストと背景の上の指の操作のどれでも、後ろのページは0pxのままでした。開いているあいだ後ろのページを動かさないだけなら、検証環境ではこの1行で足りました。

overscroll-behavior: contain だけで済ませる形は、背景の上からはページを動かせるまま残し、中のリストを読み終えたときだけ後ろへ伝えたくない場合に向きます。

中身が短く、スクロールしないモーダル

項目を3つにして、リストがスクロールしない状態でも試しました。リストの上でホイールを回すと、指定なしではページが300px、600pxと動き、.dialog-body に contain を付けると0pxのままでした。指で動かした場合も、指定なしでは後ろのページが動き、contain では0pxのままでした。

MDN の overscroll-behavior のページには、スクロールできる量がないスクロールコンテナーは常にスクロール境界にあるとみなされ、contain などを付けると親へのスクロール連鎖が防がれる、とあります。

ただし、ブラウザーによって対応に差があります。@mdn/browser-compat-data 8.1.8 の互換性データでは、Chrome は 144 から、Firefox は 150 からこの動きに対応しています。それより前の版と Safari には「スクロールできる量がないスクロールコンテナーには効果がない」という注記があります。この注記のとおりなら、中身が短いモーダルでは、ブラウザーによっては contain を付けても後ろへの連鎖が止まりません。

中身がスクロールするときの contain と none は、同じ互換性データで、Chrome は 63、Edge は 79、Firefox は 59、Safari は 16 から対応しています。

​Posted by 86