【JavaScript】<dialog>要素で作るモダンなモーダルウィンドウ!背景クリックやスクロール固定の実装デモ

モーダルウィンドウを実装する際、従来は <div> 要素を重ねて z-index や aria-hidden、Escape キーのイベント監視などをすべて自作するのが一般的でした。

関連記事

しかし現在では、すべてのモダンブラウザでHTML標準の <dialog> 要素 がサポートされており、第一選択肢として使われるようになっています。

<dialog> 要素の専用メソッドである showModal() を使えば、キーボード操作(Esc キーでの終了やフォーカスの閉じ込め)や背景のオーバーレイ表示をブラウザが標準機能として自動で処理してくれます!

一方で、「外側(背景)クリックで閉じる処理の作り方」や「背面スクロールのロック解除タイミング」など、<dialog> 特有の仕様を知らないと思わぬバグにハマるポイントもあります。 今回は、<dialog> 要素を使った実践的なモーダル実装デモとともに、メリット・デメリットや注意点を詳しく解説します!

デモ動作

See the Pen Untitled by mikanbako (@mikanbako) on CodePen.

全画面でのデモ動作は以下のリンクからご確認下さい!(別タブで開かれます)

実装コード紹介

【HTML】

<!-- 背面のページコンテンツ -->
<div class="l-page">
  <div class="l-wrap">
    <h2>&lt;dialog&gt; 要素で作るモダンなモーダル実装デモ</h2>
    <p class="p-desc">標準メソッド <code>showModal()</code> を使った実装です。背景クリックや Escキー、スクロールの挙動を試してみてね!</p>

    <div class="p-card">
      <p>👇 下のボタンで &lt;dialog&gt; モーダルが開きます</p>
      <button class="c-btn-open js-dialog-open" data-dialog-open="dialog-sample" type="button">
        dialogモーダルを開く
      </button>
    </div>

    <div class="p-dummy-scroll">
      <p>🔽 ここは背面のページコンテンツです(下へスクロールできます)</p>
      <p>CSSの <code>body:has(dialog[open])</code>(+JSのクラス制御)によって、モーダル表示中は背面スクロールが自動でロックされます!</p>
      <p>🔽 スクロール確認用ダミーテキスト 🔽</p>
    </div>
  </div>
</div>

<!-- 💡 モーダル本体:HTML標準の <dialog> 要素を使用! -->
<!-- ⚠️ 注意点:dialog自体には padding を付けず、内側に .c-dialog__inner を1枚挟むのが鉄則! -->
<dialog id="dialog-sample" class="c-dialog js-dialog" aria-labelledby="dialog-title">
  <div class="c-dialog__inner">
    
    <!-- ヘッダー -->
    <div class="c-dialog__header">
      <h3 id="dialog-title" class="c-dialog__title">✨ &lt;dialog&gt; 要素のモーダル</h3>
      <button class="c-dialog__close-icon js-dialog-close" type="button" aria-label="閉じる">×</button>
    </div>

    <!-- ボディ(内部スクロール可能エリア) -->
    <div class="c-dialog__body">
      <p><strong>【&lt;dialog&gt; 要素ならではの注目ポイント!】</strong></p>
      <ul>
        <li>✅ JSで <code>keydown</code> イベントを書かなくても、標準機能で <code>Esc</code> キーで閉じます!</li>
        <li>✅ 背景の黒い半透明幕は、HTML要素ではなく疑似要素 <code>dialog::backdrop</code> で自動生成されています。</li>
        <li>✅ Tabキーを押した際、フォーカスが背面ページに逃げない「フォーカストラップ」が最初から効いています!</li>
      </ul>
      <div class="c-dialog__scroll-demo">
        <p>--- モーダル内スクロール確認エリア ---</p>
        <p>背面のスクロールはロックしつつ、このボックスの中身だけは縦スクロールできます👇</p>
        <p>1. ダミーテキスト...</p>
        <p>2. ダミーテキスト...</p>
        <p>3. ダミーテキスト...</p>
        <p>🎉 一番下までスクロールできました!</p>
      </div>
    </div>

    <!-- フッター -->
    <div class="c-dialog__footer">
      <button class="c-btn-close js-dialog-close" type="button">閉じる</button>
    </div>

  </div>
</dialog>

【CSS】

/* 💡 モダンな背面スクロール禁止:開いている dialog[open] が存在する時だけ body をロック! */
body:has(dialog[open]),
body.is-scroll-lock {
  overflow: hidden;
}

.l-page {
  padding: 40px 20px 120px;
  text-align: center;
}

.l-wrap {
  max-width: 600px;
  margin: 0 auto;
}

h2 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.p-desc {
  margin-bottom: 25px;
  font-size: 16px;
  font-weight: bold;
  color: #666;
  line-height: 1.6;
}

.p-desc code {
  padding: 2px 6px;
  color: #e83e8c;
  background: #e9ecef;
  border-radius: 4px;
}

.p-card {
  padding: 30px;
  margin-bottom: 30px;
  font-weight: bold;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

.c-btn-open {
  margin-top: 20px;
  padding: 14px 28px;
  font-family: inherit;
  font-size: 16px;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #1bb4d4;
  border: none;
  border-radius: 8px;
  transition: 0.2s;
}

.c-btn-open:hover {
  opacity: 0.85;
  transform: translateY(-2px);
}

.p-dummy-scroll {
  display: flex;
  flex-direction: column;
  gap: 30vh;
  padding: 40px 20px;
  font-weight: bold;
  color: #555;
  background: #e9ecef;
  border: 2px dashed #adb5bd;
  border-radius: 12px;
}

/* =========================================
   💡 <dialog> 要素と ::backdrop のスタイル
========================================= */
.c-dialog {
  width: 90%;
  max-width: 500px;

  /* ⚠️ 超重要:外側クリック判定を正確にするため、dialog自体の padding は必ず 0 にする! */
  padding: 0;
  overflow: hidden;
  background: #fff;
  border: none;
  border-radius: 12px;
  box-shadow: 0 10px 30px rgb(0 0 0 / 25%);
}

/* 開いた時([open]属性が付いた時)のふわっと表示アニメーション */
.c-dialog[open] {
  animation: dialogFadeIn 0.3s ease-out forwards;
}

/* 💡 専用の疑似要素 ::backdrop で背景の黒いオーバーレイを装飾! */
.c-dialog::backdrop {
  background: rgb(0 0 0 / 60%);
  backdrop-filter: blur(2px);
  animation: backdropFadeIn 0.3s ease-out forwards;
}

@keyframes dialogFadeIn {
  from {
    opacity: 0;
    transform: translateY(15px) scale(0.98);
  }

  to {
    opacity: 1;
    transform: translateY(0) scale(1);
  }
}

@keyframes backdropFadeIn {
  from {
    opacity: 0;
  }

  to {
    opacity: 1;
  }
}

/* 内側のラッパー(ここにレイアウトや余白を持たせる) */
.c-dialog__inner {
  display: flex;
  flex-direction: column;
  max-height: 85vh;
}

/* ヘッダー・ボディ・フッター */
.c-dialog__header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 16px 20px;
  border-bottom: 1px solid #eee;
}

.c-dialog__title {
  margin: 0;
  font-size: 18px;
  color: #1bb4d4;
}

.c-dialog__close-icon {
  padding: 0 4px;
  font-size: 22px;
  line-height: 1;
  color: #888;
  cursor: pointer;
  background: none;
  border: none;
}

.c-dialog__close-icon:hover {
  color: #333;
}

.c-dialog__body {
  padding: 20px;
  overflow-y: auto;
  font-size: 14px;
  line-height: 1.6;
  text-align: left;
}

.c-dialog__body ul {
  display: flex;
  flex-direction: column;
  gap: 10px;
  padding-left: 20px;
  margin-top: 16px;
}

.c-dialog__body code {
  padding: 2px 6px;
  font-weight: bold;
  color: #e83e8c;
  background: #f1f3f5;
  border-radius: 4px;
}

.c-dialog__scroll-demo {
  display: flex;
  flex-direction: column;
  gap: 10vh;
  padding: 15px;
  margin-top: 15px;
  background: #f8f9fa;
  border: 1px solid #dee2e6;
  border-radius: 8px;
}

.c-dialog__footer {
  padding: 12px 20px;
  text-align: right;
  background: #fafafa;
  border-top: 1px solid #eee;
}

.c-btn-close {
  padding: 8px 20px;
  font-size: 16px;
  font-family: inherit;
  font-weight: bold;
  color: #fff;
  cursor: pointer;
  background: #6c757d;
  border: none;
  border-radius: 6px;
}

.c-btn-close:hover {
  background: #5a6268;
}

【JavaScript】

const openButtons = document.querySelectorAll('.js-dialog-open');
const dialogs = document.querySelectorAll('.js-dialog');

// 1. 開くボタンのクリックイベント
openButtons.forEach(btn => {
  btn.addEventListener('click', () => {
    const targetId = btn.dataset.dialogOpen;
    const targetDialog = document.getElementById(targetId);

    if (targetDialog) {
      // 💡 専用メソッド showModal() を呼ぶだけでモーダルとして開く!
      targetDialog.showModal();
      document.body.classList.add('is-scroll-lock');
    }
  });
});

// 2. 各 dialog の閉じる処理の設定
dialogs.forEach(dialog => {
  // ① 閉じるボタンをクリックした時に close() メソッドを呼ぶ
  const closeButtons = dialog.querySelectorAll('.js-dialog-close');
  closeButtons.forEach(btn => {
    btn.addEventListener('click', () => {
      dialog.close();
    });
  });

  // ② 外側(::backdrop 背景部分)をクリックした時に閉じる!
  dialog.addEventListener('click', (e) => {
    // dialog 自体の padding を 0 にして内側に .c-dialog__inner を入れているため、
    // 白いボックス内をクリックした時は e.target が内側要素になり、
    // 外側の ::backdrop をクリックした時だけ e.target === dialog になる!
    if (e.target === dialog) {
      dialog.close();
    }
  });

  // ③ 💡 重要:モーダルが閉じた時(ボタンでも Escキーでも!)に必ず発火する専用イベント
  dialog.addEventListener('close', () => {
    // ここでスクロールロックを解除すれば、Escキーで閉じた時も解除漏れが起きない!
    document.body.classList.remove('is-scroll-lock');
  });
});

dialog要素のメリット・デメリットと実装の要点

<div> 実装と <dialog> 実装の比較

機能・実装項目従来の <div> 実装<dialog> 要素の実装
開閉の切り替えクラスの着脱.is-open専用メソッド showModal() / close()
背景オーバーレイ外側に専用 div を配置疑似要素 dialog::backdrop で自動生成
Escキーで閉じるJSで keydown イベントを自作標準機能で自動対応
(JS不要!)
フォーカス閉じ込めJSで複雑な制御が必要標準機能で自動対応
(JS不要!)
重なり順(z-index)z-index の指定が必要最上位レイヤーに強制表示
(z-index不要)

<dialog> を使う最大のメリット:showModal() と ::backdrop

開くメソッドには show() と showModal() の2種類がありますが、モーダルウィンドウとして使う場合は必ず dialog.showModal() を使用します。

showModal() を実行すると、ブラウザの「最上位レイヤー(Top Layer)」に要素が配置されるため、他の要素の z-index がいくつであっても絶対に一番手前に表示されます。また、背面の要素には一切フォーカスが当たらなくなり(不活性化)、スクリーンリーダーの読み上げ範囲もモーダル内に限定されるなど、アクセシビリティ対応が一瞬で完了します。

さらに、背景の黒い半透明エリアはHTMLタグで作る必要がなく、CSSの dialog::backdrop という疑似要素で直接スタイリングできます!

/* 背景のオーバーレイを直接デザインできる! */
.c-dialog::backdrop {
  background: rgba(0, 0, 0, 0.6);
  backdrop-filter: blur(2px);
}

【重要】<dialog> 特有の注意点(デメリット)と解決策

非常に便利な <dialog> 要素ですが、使う際は以下の3つのポイントに注意が必要です。

① 外側クリック判定:<dialog> の padding は必ず 0 にする!

<dialog> 要素で背景(::backdrop)をクリックした時、クリックイベントの e.target は <dialog> 要素自身 になります。 もし <dialog> に直接 padding: 20px; を設定してしまうと、白いボックスの端(パディング領域)をクリックした時にも e.target === dialog と判定されてしまい、ボックス内をクリックしたのにモーダルが閉じてしまうバグが起きます。

【解決策】
<dialog> 本体は padding: 0; にし、すぐ内側に <div class="c-dialog__inner"> を1枚挟んでそちらに余白やレイアウトを設定しましょう!

② スクロールロック解除は close イベント(またはCSS :has())で行う!

<dialog> はブラウザ標準で背面スクロールまでは止めてくれないため、body に overflow: hidden; を指定する必要があります。 この時、閉じるボタンの click イベントだけでロック解除を書いていると、ユーザーが Esc キーで閉じた時にロックが解除されず画面がスクロール不能になるということがあります。

【解決策】
どのように閉じられた場合でも必ず発火する dialog.addEventListener('close', ...) の中でロックを解除するか、モダンCSSの body:has(dialog[open]) { overflow: hidden; } を使うのがベストです!

// モーダルが閉じた時(ボタンでも Escキーでも!)に必ず発火する専用イベント
dialog.addEventListener('close', () => {
  // ここでスクロールロックを解除すれば、Escキーで閉じた時も解除漏れが起きない!
  document.body.classList.remove('is-scroll-lock');
});
/* 背面スクロール禁止:開いている dialog[open] が存在する時だけ body をロック! */
body:has(dialog[open]) {
  overflow: hidden;
}

③ 閉じる時のフェードアウトアニメーション実装が少し難しい

dialog.close() を呼ぶと瞬時に display: none; に切り替わる仕様のため、通常の transition だけでは閉じる時のアニメーションが効きません(開く時は @keyframes で簡単にアニメーションできます)。閉じる時もアニメーションさせたい場合は、モダンCSSの @starting-style と transition-behavior: allow-discrete を組み合わせるか、JSでアニメーション完了を待ってから .close() を呼ぶ工夫が必要になります。

/* 開いた時([open]属性が付いた時)のふわっと表示アニメーション */
.c-dialog[open] {
  animation: dialogFadeIn 0.3s ease-out forwards;
}

@keyframes dialogFadeIn {
  from {
    opacity: 0;
    transform: translateY(15px) scale(0.98);
  }

  to {
    opacity: 1;
    transform: translateY(0) scale(1);
  }
}

補足:公式ドキュメント

・MDN: <dialog>要素

まとめ

今回はHTML標準の <dialog> 要素を使ったモーダルウィンドウの実装方法について解説しました。

  • dialog.showModal() で開き、dialog.close() で閉じる
  • Esc キー対応、フォーカストラップ、最上位表示がブラウザ標準で自動適用される
  • 外側クリック判定を正確にするため、<dialog> 自体は padding: 0 にし、内側に div を入れる
  • 背面スクロール解除は close イベント、または CSS の body:has(dialog[open]) で制御する

以前の <div> 要素による実装と比べると、JavaScriptで書くべきコードが減り、アクセシビリティ面でも非常に優れたモーダルが作れることがわかります。ぜひ2つの違いを理解して、プロジェクトに合わせて使い分けてみてくださいね!

Prev
Next