# 拡大表示で上下が画面からはみ出してしまうモーダル

Source: https://easeweb.dev/learn/modals-cut-off
Topics: 拡大表示、リフロー、文字間隔 > 幅320pxの画面で横スクロールなしに収まる (WCAG 1.4.10)
The fix: ダイアログがウィンドウより高くなったら、スクロールできるようにします。ダイアログの高さをウィンドウの高さから余白を引いた値までにしてoverflow-y: autoを指定するか、ダイアログを入れた背景ごとスクロールさせるか、HTML標準のdialogをshowModal()で開きます。最後の方法では、ブラウザーの標準のスタイルがはじめから高さを抑えます。
Test with: zoom, keyboard
References: https://www.w3.org/WAI/WCAG22/Understanding/reflow.html https://www.w3.org/WAI/WCAG22/Techniques/failures/F102 https://html.spec.whatwg.org/multipage/rendering.html#flow-content-3 https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/overflow-y https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Values/length

よくある問題を再現した学習用のサンプルです。実在のクライアントの診断結果ではありません。コードは出発点となる実装例のため、実際の製品でも確認してください。ここでは支援技術でのテスト結果は報告していません。

## 場面

自転車店のページで、$85のフルメンテナンスを受け付けています。「メンテナンスを予約」ボタンを押すと、ページが暗くなり、その上にダイアログが重なります。右上に閉じる「×」、見出し「フルメンテナンスの予約」、日時と料金、自転車の持ち込みと予約の変更についての短い説明が2つ並び、いちばん下に「キャンセル」と「予約を確定する」があります。ノートパソコンではウィンドウの中央に余裕をもって収まり、スマートフォンでも画面の大部分を使って収まります。

弱視の人が、幅1280 × 高さ1024ピクセルのウィンドウでページを400%に拡大して、メンテナンスを予約しようとします。拡大後のウィンドウは、CSSピクセルで320 × 256です。この幅では、お店の16ピクセルの文字と1.5の行の高さのまま、ダイアログの文章の行が増え、高さ256のウィンドウに対して、ダイアログの高さは400ピクセルを超えます。ダイアログはウィンドウの中央に置かれるため、上端から80ピクセル以上がはみ出し、下端からも同じだけはみ出します。「×」と見出しはウィンドウの上に、「キャンセル」と「予約を確定する」は下に隠れます。マウスホイールを回すと背後のページがスクロールするだけで、ダイアログは動きません。Tabキーで「予約を確定する」まで進んでも、ボタンは見えないままです。予約するには、ダイアログが収まるまで拡大を戻すしかありません。

## 確認できる問題

ダイアログは `position: fixed`、`top: 50%`、`left: 50%`、`transform: translate(-50%, -50%)` で配置されています。ボックスを中央に置くよく使われる方法です。この方法では、高さに関係なくダイアログの中心がウィンドウの中心に来ますが、高さをウィンドウに収める指定はどこにもありません。固定表示のボックスはページをスクロールしても位置が変わらず、このダイアログには自前のスクロールもありません。そのため、ウィンドウの外にはみ出した部分は、ホイールでもタッチでも、フォーカスを移しても表示できません。ウィンドウの上端より上の部分には、ページ自体のスクロールでも届きません。

達成基準1.4.10は、幅320 CSSピクセルで、情報や機能を失わずにコンテンツを表示できることを求めています。解説書は320 CSSピクセルを、幅1280ピクセルのウィンドウを400%に拡大した状態として説明しています。高さ1024ピクセルのウィンドウなら、同じ拡大で高さは256ピクセルになります。そのウィンドウでは、コンテンツはページの上に描かれてはいるものの、ウィンドウの外にあって利用者には届きません。ダイアログの見出しとボタンが失われ、予約という機能も失われています。同じ解説書は、利用者が届く限り、コンテンツを動かしても損失にはならないとしています。スクロールできるダイアログであれば十分です。W3Cが示す失敗例でいちばん近いのは、ページが320ピクセルにリフローしたあとでコンテンツが利用できなくなるF102です。

## 利用者への影響

CSSピクセルに換算すると高さの低いウィンドウでページを見る人や、ダイアログがウィンドウより高くなるほど文字を大きくしている人は、誰でも影響を受けます。デスクトップで拡大表示した場合、スマートフォンで表示サイズを大きくした場合、ブラウザーの文字サイズを大きくした場合のほか、横向きのスマートフォンでも起こります。横向きでは幅は十分でも高さが低いため、ふつうの長さのダイアログでも上下にはみ出すことがあります。

## 自動チェックとAIの限界

自動チェックはページをデスクトップのサイズで一度読み込むだけで、ダイアログは開きません。開いたとしても、そのサイズではダイアログはウィンドウに収まります。axeにはこれを調べるルールがありません。EaseWebの診断では、320 × 256 CSSピクセルで、何かを開くことが示されたボタン（`aria-haspopup`、`aria-expanded`、`aria-controls`、`popovertarget` などを持つもの）や、その幅でだけ現れるボタンを最大8つまで開き、テキストやコントロールがウィンドウの上端より上や下端より下にあり、周りにスクロールする枠もない固定表示の要素を報告するようにしました。このページの「メンテナンスを予約」ボタンにはそうした印がないため、診断では開かれず、人が開いて確かめる必要があります。デザインレビューではダイアログをノートパソコンの枠で見ることが多く、そこでは高さに余裕があります。AIアシスタントに中央に置くモーダルを頼むと、`max-height` のないこのtransformがそのまま書かれることがあります。react-modalのREADMEも、独自スタイルの例として同じ中央寄せを載せており、その課題管理には「How to allow scrolling on modal if window is too small」（ウィンドウが小さすぎるときにモーダルをスクロールさせるには）という質問があります。

## 修正前：ウィンドウの中央にtransformで置いたダイアログ

```html
<button type="button" id="book">メンテナンスを予約</button>
…
<div class="backdrop" hidden>
  <div class="booking" role="dialog" aria-modal="true" aria-labelledby="booking-title">
    <button type="button" class="close" aria-label="閉じる">×</button>
    <h2 id="booking-title">フルメンテナンスの予約</h2>
    <p>11月12日（木）10:00</p>
    <p>$85（自転車のお受け取り時にお支払い）</p>
    <p>10:00までに自転車をお持ちください。仕上がったらメールでお知らせします。たいていは当日の午後に仕上がります。</p>
    <p>ご都合が変わったら、24時間前まで無料で日時の変更やキャンセルができます。</p>
    <button type="button" class="cancel">キャンセル</button>
    <button type="button" class="confirm">予約を確定する</button>
  </div>
</div>
```

```css
.backdrop {
  position: fixed;
  inset: 0;
  background: rgb(0 0 0 / 0.5);
}
.booking {
  position: fixed;
  top: 50%;
  left: 50%;
  transform: translate(-50%, -50%);
  width: min(90%, 28rem);
  box-sizing: border-box;
  padding: 1.5rem;
  border-radius: 1rem;
  background: #fff;
}
.close {
  position: absolute;
  top: 0.75rem;
  right: 0.75rem;
}
```

```js
const book = document.querySelector('#book');
const backdrop = document.querySelector('.backdrop');
book.addEventListener('click', () => {
  backdrop.hidden = false;
  backdrop.querySelector('.close').focus();
});
// … 閉じる、キャンセル、Escapeキーで背景を隠し、「メンテナンスを予約」にフォーカスを戻す。
```

400%の拡大表示では、高さ256ピクセルのウィンドウに対して、ダイアログの高さが400ピクセルを超えます。

- transformでウィンドウの中央に置かれるため、上端から80ピクセル以上はみ出して「×」と見出しが隠れ、下端からも同じだけはみ出して「キャンセル」と「予約を確定する」が隠れます。
- ダイアログに `max-height` も `overflow` もないため、中身はスクロールしません。
- 固定表示のため、ページをスクロールしても、動くのは背後のページだけです。

## 修正後：高さをウィンドウまでに抑えたダイアログ

```html
<button type="button" id="book">メンテナンスを予約</button>
…
<div class="backdrop" hidden>
  <div class="booking" role="dialog" aria-modal="true" aria-labelledby="booking-title">
    <button type="button" class="close" aria-label="閉じる">×</button>
    <h2 id="booking-title">フルメンテナンスの予約</h2>
    <p>11月12日（木）10:00</p>
    <p>$85（自転車のお受け取り時にお支払い）</p>
    <p>10:00までに自転車をお持ちください。仕上がったらメールでお知らせします。たいていは当日の午後に仕上がります。</p>
    <p>ご都合が変わったら、24時間前まで無料で日時の変更やキャンセルができます。</p>
    <button type="button" class="cancel">キャンセル</button>
    <button type="button" class="confirm">予約を確定する</button>
  </div>
</div>
```

```css
.backdrop {
  position: fixed;
  inset: 0;
  background: rgb(0 0 0 / 0.5);
}
.booking {
  position: fixed;
  top: 50%;
  left: 50%;
  transform: translate(-50%, -50%);
  width: min(90%, 28rem);
  max-height: calc(100dvh - 2rem);
  overflow-y: auto;
  box-sizing: border-box;
  padding: 1.5rem;
  border-radius: 1rem;
  background: #fff;
}
.close {
  position: absolute;
  top: 0.75rem;
  right: 0.75rem;
}
```

```js
const book = document.querySelector('#book');
const backdrop = document.querySelector('.backdrop');
book.addEventListener('click', () => {
  backdrop.hidden = false;
  backdrop.querySelector('.close').focus();
});
// … 閉じる、キャンセル、Escapeキーで背景を隠し、「メンテナンスを予約」にフォーカスを戻す。
```

1. ダイアログに `max-height: calc(100dvh - 2rem)` を指定します。ダイアログの高さは、ウィンドウの高さから上下1remずつを引いた値を超えなくなります。transformによる中央寄せはそのままなので、ダイアログはウィンドウの中にすべて収まります。
2. `overflow-y: auto` を指定します。中身がそれより高くなると、ダイアログがスクロールします。ホイール、タッチ、矢印キーで中身が動き、Tabキーでフォーカスが移るたびに、そのボタンが見える位置までスクロールします。

これで修正前の例は直り、1.4.10を満たします。2行を足すだけの最小の変更で、ダイアログが収まる大きさでは見た目も変わりません。400%では、ボタンまで読み進めると「×」と見出しがスクロールして見えなくなり、上へ戻せばまた現れます。

## 修正後：背景ごとスクロールさせる

```html
<button type="button" id="book">メンテナンスを予約</button>
…
<div class="backdrop" hidden>
  <div class="booking" role="dialog" aria-modal="true" aria-labelledby="booking-title">
    <button type="button" class="close" aria-label="閉じる">×</button>
    <h2 id="booking-title">フルメンテナンスの予約</h2>
    <p>11月12日（木）10:00</p>
    <p>$85（自転車のお受け取り時にお支払い）</p>
    <p>10:00までに自転車をお持ちください。仕上がったらメールでお知らせします。たいていは当日の午後に仕上がります。</p>
    <p>ご都合が変わったら、24時間前まで無料で日時の変更やキャンセルができます。</p>
    <button type="button" class="cancel">キャンセル</button>
    <button type="button" class="confirm">予約を確定する</button>
  </div>
</div>
```

```css
.backdrop {
  position: fixed;
  inset: 0;
  display: grid;
  padding: 1rem;
  overflow-y: auto;
  background: rgb(0 0 0 / 0.5);
}
.booking {
  position: relative;
  margin: auto;
  width: min(90%, 28rem);
  box-sizing: border-box;
  padding: 1.5rem;
  border-radius: 1rem;
  background: #fff;
}
.close {
  position: absolute;
  top: 0.75rem;
  right: 0.75rem;
}
```

```js
const book = document.querySelector('#book');
const backdrop = document.querySelector('.backdrop');
book.addEventListener('click', () => {
  backdrop.hidden = false;
  backdrop.querySelector('.close').focus();
});
// … 閉じる、キャンセル、Escapeキーで背景を隠し、「メンテナンスを予約」にフォーカスを戻す。
```

1. 背景に `overflow-y: auto` を指定します。背景はもともとウィンドウ全体を覆っているので、中のダイアログがウィンドウより高くなると、背景がスクロールし、ダイアログ全体が動きます。
2. 背景を1remの余白付きのグリッドにし、ダイアログから `position: fixed`、`top`、`left`、transformを外します。ダイアログは背景の中の通常フローに入り、その高さが背景のスクロールする量に含まれます。`position: relative` で「×」を右上に保ちます。
3. ダイアログを `margin: auto` で中央に置きます。収まるときは上下の余白が均等になって中央に来ます。ウィンドウより高いときは余白が0になり、ダイアログの上端は背景の上端から始まるため、スクロールで届きます。

これで修正前の例は直り、1.4.10を満たします。Bootstrapのモーダルや、Headless UIのドキュメントにあるダイアログも、この方法でスクロールします。ダイアログは元の高さのまま一続きで動き、上端の上と下端の下には背景が1remずつ見えます。

## 修正後：HTML標準のdialog

```html
<button type="button" id="book">メンテナンスを予約</button>
…
<dialog class="booking" id="booking" aria-labelledby="booking-title">
  <button type="button" class="close" aria-label="閉じる">×</button>
  <h2 id="booking-title">フルメンテナンスの予約</h2>
  <p>11月12日（木）10:00</p>
  <p>$85（自転車のお受け取り時にお支払い）</p>
  <p>10:00までに自転車をお持ちください。仕上がったらメールでお知らせします。たいていは当日の午後に仕上がります。</p>
  <p>ご都合が変わったら、24時間前まで無料で日時の変更やキャンセルができます。</p>
  <button type="button" class="cancel">キャンセル</button>
  <button type="button" class="confirm">予約を確定する</button>
</dialog>
```

```css
.booking::backdrop {
  background: rgb(0 0 0 / 0.5);
}
.booking {
  width: min(90%, 28rem);
  box-sizing: border-box;
  padding: 1.5rem;
  border: 0;
  border-radius: 1rem;
  background: #fff;
}
.close {
  position: absolute;
  top: 0.75rem;
  right: 0.75rem;
}
```

```js
const book = document.querySelector('#book');
const booking = document.querySelector('#booking');
book.addEventListener('click', () => {
  booking.showModal();
  booking.querySelector('.close').focus();
});
// … 閉じるとキャンセルでbooking.close()を呼ぶ。Escapeキーでも閉じ、フォーカスは「メンテナンスを予約」に戻る。
```

1. 背景とダイアログの `div` を `dialog` 要素に置き換え、見出しで名前を付けます。自前の背景の代わりに、`::backdrop` にスタイルを指定します。
2. `showModal()` で開きます。モーダルダイアログ向けのブラウザーの標準のスタイルが、ダイアログを中央に置き、ウィンドウに対して `max-height: calc(100% - 6px - 2em)` と `overflow: auto` を指定するため、高いダイアログもウィンドウに収まってスクロールします。
3. ダイアログから `position`、`top`、`left`、transformを外します。中央に置くのはブラウザーです。`min-height` や `max-height: none`、それより大きい `max-height` は指定しないでください。高さの上限がまた外れてしまいます。`box-sizing: border-box` も残してください。ブラウザーの上限は標準の1emの余白を見込んだ値なので、それより広い余白は、指定がないと上限の外に足されてしまいます。

これで修正前の例は直り、高さについてのCSSを1行も書かずに1.4.10を満たします。背後のページを操作できない状態にし、Escapeキーで閉じる処理まで、自前のスクリプトなしで備わるのはこの方法だけです。[背後にフォーカスが残るモーダル](/ja/learn/modal-focus-management)の修正も、これを前提にしています。ブラウザーによる高さの上限はHTML標準のレンダリングの節で定められていて、Chromium、Firefox、WebKitのどれもこれを適用します。

## どの方法を選ぶか

3つとも、400%の拡大表示でダイアログのどの部分にも届くようになり、1.4.10を満たします。高さを抑える方法は、今あるダイアログに2行足すだけの最小の変更で、スタイルしか変えられないコンポーネントライブラリーでも使えます。背景ごとスクロールさせる方法は、ダイアログの形を保ったまま、長いページのように一続きで動かします。見出しと最初の入力欄を離したくないフォームのように、上から下までがひとまとまりのダイアログに向いています。HTML標準のdialogはマークアップとスクリプトの変更が必要ですが、高さの上限も、フォーカスをダイアログの中に留める動作も、Escapeキーで閉じる動作も、ブラウザーが用意してくれます。コンポーネントを変えられる場合に選び、スタイルを付けるときも高さの上限は残してください。

## 実装の判断

ダイアログの中でヘッダーとフッターを固定し、真ん中だけをスクロールさせれば、「×」と「予約を確定する」はいつも見えます。Bootstrapの `modal-dialog-scrollable` やMUIの `scroll="paper"` がこの形です。ただし高さ256ピクセルのウィンドウでは、読む場所がほとんど残りません。ダイアログの上下に1remずつ余白があり、ヘッダーとフッターがそれぞれ60ピクセルなら、本文に使えるのは約100ピクセルで、幅320ピクセルでどちらかが2行に折り返せば、真ん中はなくなってしまうこともあります。この形を残すなら、幅320ピクセルでもそれぞれを1行に収め、高さの低いウィンドウ（`@media (max-height: 30em)`）ではダイアログ全体をスクロールさせてください。

スクロールするオーバーレイの中でダイアログを中央に置くときは注意が必要です。オーバーレイに `display: flex` と `align-items: center` を指定すると、ウィンドウより高いダイアログは上下両方にはみ出して中央に置かれますが、オーバーレイは下にしかスクロールできないため、上端は切れたままになります。Chakra UIの課題管理にも、[中央に置いたモーダルがスマートフォンで上端から切れるという報告](https://github.com/chakra-ui/chakra-ui/issues/2871)があります。`margin: auto`、グリッド、`align-items: safe center` なら、収まらないダイアログは上端から始まります。

ほかの浮いた要素にも、同じ問題が起こります。

- ヘッダーの下に固定したメニューや、`top: 0` と `bottom: 0` で片側に固定したドロワーは、最後のリンクまで見せるために、それ自体に `overflow-y: auto` が必要です。
- ウィンドウの下からせり上がるシートには、ダイアログと同じく `max-height` とスクロールが必要です。
- `popover` 属性で開くポップオーバーは、ブラウザーが `overflow: auto` を付けて中央に置きますが、モーダルダイアログとは違って `max-height` はないため、高いものは上下にはみ出します。

ページの下部に固定したバーは別の問題です。バーはウィンドウに収まりますが、その下のページを覆います。[拡大するとページを覆う、浮いた購入バー](/ja/learn/floating-buttons)を参照してください。

`100dvh` は、その時点のウィンドウの高さです。スマートフォンの `100vh` はブラウザーのアドレスバーが隠れたときの高さなので、`100vh` で抑えたダイアログは、アドレスバーが隠れるまでその下にはみ出すことがあります。デスクトップのブラウザーで400%に拡大した場合は、どちらも同じ値です。固定表示の要素では、パーセントがウィンドウを基準にするため、`max-height: calc(100% - 2rem)` でも同じように抑えられます。ただし、周りの要素にtransformやfilterなど、その基準を変えるプロパティがある場合は除きます。

ダイアログを開いている間、`body` に `overflow: hidden` を指定してページのスクロールを止めても、ここで説明したことは変わりません。どちらにしても、ダイアログは自分でスクロールする必要があります。スクロールする枠に `overscroll-behavior: contain` を指定すると、ダイアログの端まで来たときに背後のページが動かなくなります。

## 修正の確認

1. 幅1280 × 高さ1024ピクセルのウィンドウで、ブラウザーを400%に拡大する（または開発者ツールでビューポートを320 × 256 CSSピクセルにする）。ページにあるダイアログ、シート、メニューをすべて開く。
2. それぞれを、マウスホイールとタッチで上端と下端までスクロールする。「×」などの閉じるボタン、見出し、最後のボタンが、どれも完全に表示されることを確認する。
3. ダイアログの最初のコントロールから最後までTabキーで進み、Shift + Tabで戻る。フォーカスが移るたびに、そのコントロールが見える位置までスクロールすることを確認する。
4. 横向きのスマートフォンと、ブラウザーの文字サイズを200%にした状態で繰り返す。
5. エラーメッセージを表示した状態、長い名前や住所、すべての翻訳など、各ダイアログに入りうるいちばん長い内容で繰り返す。

OS、ブラウザーと支援技術のバージョン、ビルド、実施日、各手順の実際の結果を記録してください。ダイアログのコンポーネントやスタイルを変更した際は、再度確認します。

## 制限

このサンプルは、どのアプリケーションでも同じ結果になることを保証するものではありません。大きさはこの例のものです。実際のダイアログは、いちばん長い内容で確認してください。ダイアログがウィンドウの高さに収まっていても、幅が320ピクセルを超えてページが横にスクロールする場合は別の問題で、[狭い画面で横スクロールが出るページ](/ja/learn/reflow)で扱っています。固定ヘッダーがフォーカス中のコントロールを隠す問題は、[フォーカスしたリンクが下に隠れてしまう固定ヘッダーとバナー](/ja/learn/focus-not-obscured)で扱っています。400%で基準を満たしても、長いダイアログがその大きさで使いやすいとは限りません。読むのに何画面も必要なダイアログは、独立したページにしたほうがよいこともあります。コード内のクラス名は、実際のものに置き換えてください。

---

このガイドをコーディングエージェントで使う: MCP https://easeweb.dev/mcp（設定は https://easeweb.dev/ja/services/developers）
