HTML、CSS、JavaScriptでアクセシブルなモーダルダイアログを作る方法
ネイティブのHTMLダイアログ要素を使ってアクセシブルなモーダルダイアログを構築します。ポップアップの開閉、キーボードフォーカスの管理、バックドロップのスタイリング、JavaScriptライブラリなしで確認ダイアログを作成する方法を学びます。
HTML、CSS、JavaScriptでアクセシブルなモーダルダイアログを作成する方法
訪問者がウェブサイト上のボタンをクリックします。フォーム、確認メッセージ、または追加情報を含むポップアップが表示されます。
見た目のポップアップを作るのは簡単です。それをキーボード、スクリーンリーダー、モバイルブラウザで正しく動作させるのは別の話です。
多くのカスタムモーダル実装は、フォーカスの管理、ページとの相互作用のブロック、Escapeキーの処理のために大量のJavaScriptに依存しています。
現代のHTMLはよりシンプルなアプローチを提供します。ネイティブの<dialog>要素です。
これはモーダルダイアログに期待される動作の多くをブラウザ内で直接提供します。フレームワークやプラグインをインストールせずに、少量のHTML、CSS、JavaScriptで機能するポップアップを作成できます。
このチュートリアルでは、再利用可能なモーダルを作成し、スタイルを設定し、確認ダイアログを追加し、実際のウェブサイトで重要なアクセシビリティの詳細を探ります。
1. モーダルダイアログが通常のポップアップと異なる理由
モーダルダイアログは、訪問者がメインページに戻る前に、インターフェースの特定の部分と一時的に操作することを要求します。
典型的な例には次のものがあります:
- 項目の削除を確認する。
- お問い合わせフォームを表示する。
- ページを離れる前に確認を求める。
- 追加の商品情報を表示する。
- アプリケーション設定を編集する。
適切に実装されたモーダルは、その目的を明確にし、閉じるための明白な方法を提供し、キーボードフォーカスを適切に管理する必要があります。
ネイティブの<dialog>要素は、モーダルと非モーダルの両方の動作をサポートします。
| メソッド | 動作 |
|---|---|
showModal() |
モーダルを開き、ドキュメントの残りを不活性にする |
show() |
非モーダルダイアログを開く |
close() |
ダイアログを閉じる |
method="dialog" |
フォームのボタンでダイアログを閉じられるようにする |
モーダル動作には、ブラウザによって提供されるフォーカス管理とキーボード操作が含まれます。
2. 最初のHTMLモーダルを作成する
簡単な例から始めましょう。タイトル、テキスト、閉じるボタンを含むダイアログを開くボタンです。
<button type="button" id="openDialog">
View delivery information
</button>
<dialog id="deliveryDialog"
aria-labelledby="deliveryTitle">
<h2 id="deliveryTitle">
Delivery information
</h2>
<p>
Orders are prepared within two business days.
You will receive a tracking link by email.
</p>
<form method="dialog">
<button type="submit" autofocus>
Close
</button>
</form>
</dialog>
<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');
openButton.addEventListener('click', () => {
dialog.showModal();
});
</script>
これだけで機能するモーダルダイアログを作成できます。
訪問者がボタンをクリックすると、showModal()がページコンテンツの上にダイアログを開きます。
ブラウザはいくつかの重要な動作を自動的に処理します:
- ダイアログは最上位レイヤーに入り、通常のページコンテンツの上に表示される。
- ドキュメントの残りが不活性になる。
- キーボードフォーカスがダイアログ内に移動する。
- 通常、Escapeを押すと閉じる。
- 通常、ダイアログが閉じるとフォーカスが開いたボタンに戻る。
閉じるボタンはmethod="dialog"を使用するため、JavaScriptのイベントハンドラーは必要ありません。
3. CSSでダイアログをスタイル設定する
デフォルトのダイアログは機能しますが、見た目は基本的なものです。
角を丸くし、快適な余白、レスポンシブな幅、バックドロップを設定できます。
dialog {
width: min(90vw, 520px);
max-height: 85vh;
box-sizing: border-box;
padding: 2rem;
border: 0;
border-radius: 14px;
background: #fff;
color: #20242b;
box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
overflow: auto;
}
dialog::backdrop {
background: rgba(15, 23, 42, .65);
backdrop-filter: blur(3px);
}
dialog h2 {
margin-top: 0;
font-size: 1.5rem;
}
dialog p {
line-height: 1.6;
}
dialog button {
padding: .75rem 1.25rem;
border: 0;
border-radius: 8px;
background: #2458d3;
color: #fff;
font: inherit;
cursor: pointer;
}
dialog button:focus-visible {
outline: 3px solid #f59e0b;
outline-offset: 3px;
}
::backdrop疑似要素は、モーダルダイアログの背後にあるレイヤーをスタイル設定します。
これは、showModal()などを通じてダイアログがモーダルとして表示されている場合にのみ現れます。
show()で開かれたダイアログは、同じモーダルバックドロップの動作を自動的には受け取りません。
なぜ最上位レイヤーを使うのか?
従来のカスタムポップアップは、ますます大きなz-index値に依存することがよくあります。
showModal()で開かれたモーダルダイアログはブラウザの最上位レイヤーに入るため、多くのスタッキングコンテキストの問題を回避できます。
これは、固定ヘッダー、フローティングウィジェット、複雑なページビルダーを含むウェブサイトで特に役立ちます。
4. キーボードアクセシビリティを理解する
モーダルはマウスなしで動作する必要があります。
訪問者がTabキーを使ってウェブサイトをナビゲートする状況を想像してください。モーダルが開いたとき、背後のページに誤って移動することなく、そのコントロールを操作できるべきです。
ネイティブのモーダルダイアログはこの動作を支援します。
W3Cは、HTML dialog要素を、フォーカスの封じ込めやダイアログが閉じたときのフォーカス返却を含む、アクセシブルなモーダルダイアログを作成するためのテクニックとして説明しています。
ダイアログにアクセシブルな名前を付ける
可視の見出しを使用し、aria-labelledbyで参照します:
<dialog aria-labelledby="settingsTitle">
<h2 id="settingsTitle">Account settings</h2>
...
</dialog>
これにより、支援技術にダイアログの意味のある名前が提供されます。
初期フォーカスを慎重に選ぶ
autofocus属性は、モーダルが開いたときにフォーカスを受け取るべきコントロールを指定できます。
情報提供のダイアログでは、閉じるボタンにフォーカスするのが適切な場合があります。

フォームでは、最初の入力にフォーカスする方が理にかなう場合があります。
破壊的な確認では、キャンセルなど安全なアクションにフォーカスする方が望ましいことがよくあります。
tabindexを<dialog>要素に直接配置することは避けてください。HTML仕様はその要素自体へのその属性の使用を禁止しています。
常に可視の閉じるボタンを提供する
Escapeで通常モーダルダイアログを閉じられるとしても、可視の閉じるコントロールは依然として不可欠です。
モバイルの訪問者には物理キーボードがない場合があり、Escapeでポップアップを閉じられることを知らないユーザーもいます。
5. 2つのボタンを備えた確認ダイアログを作成する
次に、より実用的な例を構築しましょう。保存済み項目の削除を確認するものです。
訪問者はキャンセルまたは削除を選択できるべきです。
HTMLは、method="dialog"とダイアログのreturnValueプロパティを通じて便利な仕組みを提供します。
<button type="button" id="deleteItem">
Delete item
</button>
<dialog id="confirmDialog"
aria-labelledby="confirmTitle">
<h2 id="confirmTitle">
Delete this item?
</h2>
<p>
This action cannot be undone.
</p>
<form method="dialog">
<button value="cancel" autofocus>
Cancel
</button>
<button value="confirm">
Delete
</button>
</form>
</dialog>
<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');
deleteButton.addEventListener('click', () => {
confirmDialog.returnValue = 'cancel';
confirmDialog.showModal();
});
confirmDialog.addEventListener('close', () => {
if (confirmDialog.returnValue === 'confirm') {
// Call your application deletion logic here.
console.log('Deletion confirmed');
}
});
</script>
重要な詳細は、method="dialog"フォーム内のボタンをクリックするとダイアログが閉じ、そのreturnValueが設定されることです。
私たちのコードは、ユーザーがconfirmを選択したかどうかを確認します。
開く前に値をリセットすることで、ユーザーがEscapeでダイアログを閉じた場合に、以前の確認が新しい確認と誤認されるのを防ぎます。
この例は意図的に何も削除しません。実際のアプリケーションでは、確認されたアクションは、必要な認可とCSRF保護を備えた独自のPHPエンドポイントまたはアプリケーションコントローラーを呼び出すでしょう。
6. 確認ワークフローをテストする
有用なデモは、それぞれに削除ボタンがある保存済み項目のリストです。削除をクリックすると確認ダイアログが開くべきです。キャンセルは項目を変更せずに残し、確認は選択した項目だけを削除するべきです。
これは実際のウェブサイトデータを変更せずに確認フローを示します。
7. ダイアログ内にお問い合わせフォームを追加する
お問い合わせフォームももう1つの一般的なユースケースです。
ただし、ダイアログを閉じることとサーバーにデータを送信することの間には重要な違いがあります。
method="dialog"を備えたフォームはポップアップを閉じます。PHPバックエンドへの従来のHTTPリクエストは送信しません。
実際のお問い合わせフォームには、通常のフォーム送信またはAJAXリクエストを使用してください。
たとえば:
<dialog id="contactDialog"
aria-labelledby="contactTitle">
<h2 id="contactTitle">
Contact us
</h2>
<form action="/contact-handler.php" method="post">
<label for="contactEmail">
Your email
</label>
<input
type="email"
id="contactEmail"
name="email"
required
autocomplete="email"
autofocus
>
<label for="contactMessage">
Your message
</label>
<textarea
id="contactMessage"
name="message"
required
></textarea>
<button type="submit">
Send message
</button>
<button type="button" id="closeContact">
Cancel
</button>
</form>
</dialog>
送信ボタンはフォームを通常どおり送信します。
キャンセルボタンは送信せずにダイアログを閉じるべきです:
document.getElementById('closeContact')
.addEventListener('click', () => {
document.getElementById('contactDialog').close();
});
PHPハンドラーは依然として送信データを検証し、スパム対策を実装し、意味のある成功またはエラー応答を返す必要があります。
モーダルダイアログはインターフェースを改善しますが、サーバー側のフォームセキュリティを置き換えるものではありません。
8. ユーザーは外側をクリックしてダイアログを閉じられるか?
多くのウェブサイトでは、訪問者がバックドロップをクリックしてポップアップを閉じられるようになっています。
この動作はしばしばライトディスミスと呼ばれます。
現代のHTMLにはclosedby属性が含まれており、ダイアログを外部操作、プラットフォームの閉じる要求、または明示的なコントロールを通じて閉じられるかどうかを指定できます。
たとえば:
<dialog id="infoDialog" closedby="any">
<h2>More information</h2>
<p>Additional details appear here.</p>
<form method="dialog">
<button>Close</button>
</form>
</dialog>
closedby="any"値は、それをサポートするブラウザでライトディスミス動作を許可します。
ただし、新しいダイアログ機能のサポートは対象ブラウザに対して確認する必要があります。基本的なshowModal()およびclose() APIの方がより広く確立されています。
重要な確認ダイアログでは、偶発的な外部クリックによる閉じが望ましくない場合があります。
いずれの場合も、可視の閉じるまたはキャンセルコントロールを維持してください。
9. これらの一般的な実装ミスを避ける

open属性を追加してモーダルを開く
このコード:
dialog.setAttribute('open', '');
は、次の同じ動作を提供しません:
dialog.showModal();
open属性はダイアログを非モーダルで表示します。ドキュメントの残りを自動的に不活性にするわけではありません。
実際のモーダルが必要な場合はshowModal()を使用してください。
モーダルを閉じるためにopen属性を削除する
アクティブなモーダルから手動でopen属性を削除することは避けてください。
次を使用してください:
dialog.close();
これは意図されたライフサイクルに従い、適切な閉じる動作を保証します。
ボタンの代わりにリンクを使用する
インターフェースのアクションを開くコントロールは、通常ボタンであるべきです:
<button type="button">Open settings</button>
別のリソースへのナビゲーションにはリンクを使用してください。
フォーカスの可視性を忘れる
キーボードでナビゲートするユーザーには、どのコントロールがアクティブかを示す可視の表示が必要です。
ブラウザのフォーカスアウトラインを代替なしで削除するのではなく、明確な:focus-visibleスタイルを維持してください。
ダイアログを非表示コンテナ内に配置する
親コンテナが非表示である場合、またはCMSが周囲のマークアップを動的に置き換える場合、ダイアログが予期しない動作をする可能性があります。
ページビルダーとの統合では、安定したコンテナを優先し、ダイアログがドキュメントに挿入された後にJavaScriptが実行されるようにしてください。
10. ダイアログをWordPressまたはJoomlaに統合する
ネイティブのdialog要素を使用するためだけに拡張機能を作成する必要はありません。
シンプルなウェブサイトでは、統合は3つの部分で構成されます:
| 部分 | 配置場所 |
|---|---|
| HTMLマークアップ | カスタムHTMLブロック、モジュール、テンプレート、またはページビルダー要素 |
| CSS | テーマまたはテンプレートのカスタムCSS |
| JavaScript | テーマ/テンプレートのカスタムJavaScript、またはサポートされているコード挿入機能 |
WordPress
WordPressでは、アカウントとエディター設定が必要なマークアップを許可していれば、HTMLをカスタムHTMLブロックに配置できます。
スタイル設定は、テーマでサポートされているカスタムCSSの仕組みを通じて追加してください。
JavaScriptには、テーマがサポートするスクリプト領域、子テーマ、またはJavaScriptを正しく処理する信頼できるコード挿入拡張機能を使用してください。
一部のエディターやセキュリティ設定は<script>要素をフィルタリングします。コンテンツブロックに直接貼り付けたJavaScriptが実行されると仮定しないでください。
Joomla
Joomlaでは、カスタムモジュール、または適切なHTMLマークアップを許可するエディターにダイアログを含めることができます。
CSSはテンプレートのカスタムスタイルシートに追加してください。たとえば、Cassiopeiaベースのサイトではuser.cssです。
JavaScriptは、テンプレートがサポートするカスタムスクリプトの場所、または適切な拡張機能を通じて配置してください。
設定されたエディターとテキストフィルターによっては、Joomlaがコンテンツ保存時に特定の要素や属性を削除する場合があります。
マークアップが消える場合は、同じコードを何度も貼り付けるのではなく、エディターとフィルタリング設定を確認してください。
ページビルダー
同じ原則がビジュアルページビルダーにも当てはまります。それらのHTML、CSS、JavaScript統合機能を使用してください。
動的に読み込まれるコンテンツでは、関連する要素が存在した後にのみイベントリスナーを初期化してください。
ページに複数のダイアログが含まれる場合は、それぞれに一意のIDを付けてください。
11. 公開前にモーダルをテストする
デスクトップで正しく見えるダイアログでも、 usabilityの問題が残っている場合があります。
マウス、キーボード、モバイルデバイスでテストしてください。
| テスト | 期待される結果 |
|---|---|
| 開くボタンをクリック | ダイアログが表示される |
| Tabを押す | フォーカスがモーダルのコントロール内に留まる |
| Shift + Tabを押す | 逆方向のキーボードナビゲーションが機能する |
| Escapeを押す | 許可されている場合にダイアログが閉じる |
| 閉じるまたはキャンセルをクリック | ダイアログが閉じる |
| ダイアログを閉じる | フォーカスが適切に戻る |
| モバイルで開く | コンテンツが読みやすくスクロール可能なままである |
| 無効なフォームを送信 | 検証フィードバックが表示される |
| 有効なフォームを送信 | アプリケーションがデータを正しく処理する |
| スクリーンリーダーを使用 | ダイアログに理解可能な名前がある |
W3CのWCAGテクニックH102は、ネイティブのモーダル動作を検証するための有用なガイダンスを提供します。
12. いつプラグインの代わりにダイアログを使うべきか?
ネイティブのダイアログは、確認、情報パネル、シンプルなフォームなど、小さく焦点を絞ったインタラクションに特に適しています。
複数ステップのウィザード、高度なギャラリー、CMSワークフローと深く統合されたダイアログなど、より複雑なニーズには、専用のコンポーネントや拡張機能の方が保守しやすい選択肢であり続ける場合があります。
ネイティブアプローチの利点は、別のJavaScript依存関係を導入することなく、ブラウザがサポートする堅実な基盤を提供することです。
また、自分で実装する必要のあるカスタムのフォーカス管理とキーボード管理の量も減らします。
結論: ブラウザの組み込み機能から始める
モーダルダイアログに大規模なJavaScriptライブラリが必要である必要はありません。
ネイティブHTMLの<dialog>要素は、アクセシブルなポップアップ、確認メッセージ、フォームのための効果的な基盤を提供します。
showModal()、close()、method="dialog"、そしていくつかのCSSルールを使用すれば、組み込みのフォーカスとキーボード動作の恩恵を受けながら、現代のブラウザで動作するインターフェースを作成できます。
WordPress、Joomla、カスタムPHPのウェブサイトでは、比較的シンプルなインタラクションのために別のプラグインをインストールする代わりに、効率的な選択肢となります。
重要なのは、ネイティブの動作を正しく使用し、明確なコントロールを提供し、実際のキーボード操作とモバイル操作で結果をテストすることです。