【JavaScript】<dialog>要素で作るモダンなモーダルウィンドウ!背景クリックやスクロール固定の実装デモ
- 1. デモ動作
- 2. 実装コード紹介
- 2.1. 【HTML】
- 2.2. 【CSS】
- 2.3. 【JavaScript】
- 3. dialog要素のメリット・デメリットと実装の要点
- 3.1. <div> 実装と <dialog> 実装の比較
- 3.2. <dialog> を使う最大のメリット:showModal() と ::backdrop
- 3.3. 【重要】<dialog> 特有の注意点(デメリット)と解決策
- 3.3.1. ① 外側クリック判定:<dialog> の padding は必ず 0 にする!
- 3.3.2. ② スクロールロック解除は close イベント(またはCSS :has())で行う!
- 3.3.3. ③ 閉じる時のフェードアウトアニメーション実装が少し難しい
- 3.4. 補足:公式ドキュメント
- 4. まとめ
モーダルウィンドウを実装する際、従来は <div> 要素を重ねて z-index や aria-hidden、Escape キーのイベント監視などをすべて自作するのが一般的でした。
関連記事
【JavaScript】モーダルウィンドウの作り方!背景クリックで閉じる処理や背面スクロール禁止の実装デモ
しかし現在では、すべてのモダンブラウザでHTML標準の <dialog> 要素 がサポートされており、第一選択肢として使われるようになっています。
<dialog> 要素の専用メソッドである showModal() を使えば、キーボード操作(Esc キーでの終了やフォーカスの閉じ込め)や背景のオーバーレイ表示をブラウザが標準機能として自動で処理してくれます!
一方で、「外側(背景)クリックで閉じる処理の作り方」や「背面スクロールのロック解除タイミング」など、<dialog> 特有の仕様を知らないと思わぬバグにハマるポイントもあります。 今回は、<dialog> 要素を使った実践的なモーダル実装デモとともに、メリット・デメリットや注意点を詳しく解説します!
デモ動作
See the Pen Untitled by mikanbako (@mikanbako) on CodePen.
demo: dialog要素で作るモーダルウィンドウ!
実装コード紹介
【HTML】
<!-- 背面のページコンテンツ -->
<div class="l-page">
<div class="l-wrap">
<h2><dialog> 要素で作るモダンなモーダル実装デモ</h2>
<p class="p-desc">標準メソッド <code>showModal()</code> を使った実装です。背景クリックや Escキー、スクロールの挙動を試してみてね!</p>
<div class="p-card">
<p>👇 下のボタンで <dialog> モーダルが開きます</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">✨ <dialog> 要素のモーダル</h3>
<button class="c-dialog__close-icon js-dialog-close" type="button" aria-label="閉じる">×</button>
</div>
<!-- ボディ(内部スクロール可能エリア) -->
<div class="c-dialog__body">
<p><strong>【<dialog> 要素ならではの注目ポイント!】</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);
}
}
補足:公式ドキュメント
まとめ
今回はHTML標準の <dialog> 要素を使ったモーダルウィンドウの実装方法について解説しました。
dialog.showModal()で開き、dialog.close()で閉じるEscキー対応、フォーカストラップ、最上位表示がブラウザ標準で自動適用される- 外側クリック判定を正確にするため、
<dialog>自体はpadding: 0にし、内側にdivを入れる - 背面スクロール解除は
closeイベント、または CSS のbody:has(dialog[open])で制御する
以前の <div> 要素による実装と比べると、JavaScriptで書くべきコードが減り、アクセシビリティ面でも非常に優れたモーダルが作れることがわかります。ぜひ2つの違いを理解して、プロジェクトに合わせて使い分けてみてくださいね!