Dialog

モーダル ダイアログは、ウェブページでユーザーを中断する特別なタイプのポップアップ ボックスです。ダイアログをポップアップ表示する有効なユースケースはいくつかありますが、ダイアログを追加する前に、慎重に検討する必要があります。モーダル ダイアログは、ユーザーに特定のコンテンツに集中させ、ページの残りの部分を一時的に無視させます。

ダイアログには次の種類があります。

  • モーダル: ユーザーはダイアログ内のコンテンツのみを操作できます。モーダル ダイアログは、ページ コンテンツの上に表示されます。ページは不活性に設定され、デフォルトでは半透明の背景で隠されます。
  • 非モーダル: ユーザーはダイアログの外にあるコンテンツを操作できます。

ダイアログを作成するためのセマンティック HTML <dialog> 要素には、セマンティクス、キーボード操作、HTMLDialogElement インターフェースのすべてのプロパティとメソッドが付属しています。

モーダル <dialog> の例を見てみましょう。[Open modal dialog] をクリックします。 開いたダイアログを閉じるには、3 つの方法があります。1 つは Esc キーを押す方法、もう 1 つは formmethod="dialog" が設定されたボタン(またはフォーム自体に method="dialog" が設定されている場合)を使用してフォームを送信する方法、もう 1 つは HTMLDialogElement.close() メソッドを使用する方法です。

HTMLDialogElement には、HTMLElement から継承されたすべてのメソッドに加えて、3 つの主なメソッドがあります。

dialog.show() /* opens the dialog */
dialog.showModal() /* opens the dialog as a modal */
dialog.close() /* closes the dialog */

この <dialog> は HTMLDialogElement.showModal() メソッドで開かれたため、モーダル ダイアログです。モーダル ダイアログを開くと、ダイアログ自体以外のすべてが無効になり、隠されます。ダイアログの外側の UI にカーソルを合わせると、すべての要素が pointer-events: none; が設定されているかのように動作します。ダイアログを開くボタンも操作に反応しません。

ダイアログが開くと、フォーカスがダイアログに移動します。フォーカスは、そのダイアログ内の順次キーボード ナビゲーション順序の最初の要素に設定されます。tab キーを繰り返し押すと、モーダルが開いている間はダイアログ内のコンテンツのみにフォーカスが移動します。モーダルの外側にあるものはすべて不活性のままです。

ダイアログを閉じると、モーダルかどうかにかかわらず、フォーカスはダイアログを開いた要素に戻ります。ユーザー アクションなしでプログラムによってダイアログを開かないようにします。どうしても必要な場合は、ダイアログが開く前の場所にフォーカスを戻すようにします。特に、ユーザーがダイアログを操作せずに閉じた場合は、そのようにします。

グローバルな inert 属性を使用すると、アクティブなダイアログ以外の要素とそのすべての子孫を無効にできます。showModal() を使用してモーダル ダイアログを開くと、デフォルトで不活性化または無効化が行われます。属性が明示的に設定されていない。

ダイアログ以外のすべてを隠す背景は、::backdrop 疑似要素を使用してスタイル設定できます。バックドロップは、.showModal() メソッドで <dialog> が表示されている場合にのみ表示されます。この疑似要素は、FullScreen API の使用時に表示される背景(画面やモニターと同じアスペクト比ではない全画面表示モードで動画を視聴する場合など)を含む、すべての背景に一致します。

非モーダル ダイアログ

HTMLDialogElement.show() も同様にダイアログを開きますが、背景を追加したり、不活性化したりすることはありません。Esc キーはモーダル ダイアログのみを閉じ、非モーダル ダイアログは閉じません。そのため、非モーダル ダイアログを閉じる方法を含めることがさらに重要になります。閉じるオプションがダイアログの外にある場合、フォーカスはダイアログを開いた要素に戻ります。これは、ユーザー エクスペリエンスとして理想的ではありません。

ダイアログを閉じるボタンは、仕様では正式に必須とされていませんが、必須と考えてください。フォーカスを受け取ることができる表示ボタンにより、ユーザー補助機能とユーザー エクスペリエンスが向上します。

ダイアログを閉じる

ダイアログを閉じるために HTMLDialogElement.close() メソッドは必要ありません。JavaScript はまったく必要ありません。JavaScript を使用せずに <dialog> を閉じるには、<form> に method="dialog" を設定するか、ボタンに formmethod="dialog" を設定して、ダイアログ メソッドを含むフォームを追加します。

ユーザーが dialog メソッドを使用して送信すると、ユーザーが入力したデータの状態が維持されます。送信イベントが発生すると、フォームは制約検証を通過します(novalidate が設定されている場合を除く)。ユーザーデータは消去も送信もされません。JavaScript を使用せずに閉じるボタンを作成できます。

<dialog open>
  <form method="dialog">
    <button type="submit" autofocus>close</button>
  </form>
</dialog>

この例では、終了 <button> に autofocus 属性が設定されています。<dialog> 内に autofocus 属性が設定されている要素は、ダイアログが表示された状態でページがすでに読み込まれている場合にのみ、ページの読み込み時にフォーカスを受け取ります。ページが読み込まれていない場合、ダイアログが開いたときにこれらの要素にフォーカスが移ります。

ダイアログが開かれると、別の要素に autofocus 属性が設定されていない限り、ダイアログ内の最初のフォーカス可能な要素がフォーカスを受け取ります。閉じるボタンに autofocus 属性を設定すると、ダイアログが開いたときにフォーカスが当たるようになります。ただし、<dialog> 内に autofocus を含める場合は、慎重に検討する必要があります。自動フォーカスされた要素の前にあるシーケンス内のすべての要素はスキップされます。この属性については、フォーカス モジュールで詳しく説明します。

HTMLDialogElement インターフェースには、returnValue プロパティが含まれています。method="dialog" を含むフォームを送信すると、フォームの送信に使用された送信ボタンの name(存在する場合)に returnValue が設定されます。<button type="submit" name="toasty">close</button> と記述した場合、returnValue は toasty になります。

ダイアログが開いているときは、ブール値の open 属性が存在します。これは、ダイアログがアクティブで、操作できることを意味します。.show() や .showModal() ではなく open 属性を追加してダイアログを開くと、ダイアログはモーダルレスになります。HTMLDialogElement.open プロパティは、ダイアログが操作可能かどうかに応じて true または false を返します。モーダルかどうかは関係ありません。

ダイアログを開くには JavaScript を使用することをおすすめしますが、ページ読み込み時に open 属性を追加し、.close() で削除すると、JavaScript が使用できない場合でもダイアログを使用できるようになります。

補足情報

tabindex は使用しないでください。

ダイアログを開くために有効化される要素と、ダイアログに含まれる閉じるボタン(およびその他のコンテンツ)は、フォーカスを受け取ることができ、インタラクティブです。<dialog> 要素はインタラクティブではなく、フォーカスを受け取りません。tabindex プロパティをダイアログ自体に追加しないでください。

ARIA ロール

暗黙的なロールは dialog です。ダイアログが、ユーザーの応答または確認を必要とするメッセージを伝える確認ウィンドウである場合は、role="alertdialog" を設定します。ダイアログにユーザー補助機能用の名前を含めます。表示されるテキストでユーザー補助機能用の名前を指定できる場合は、aria-labelledby="idOfLabelingText" を追加します。

CSS のデフォルト

ブラウザには dialog のデフォルトのスタイルが用意されています。Firefox、Chrome、Edge は color: CanvasText; と background-color: Canvas; を設定します。Safari は、ユーザー エージェント スタイルシートで color: black; background-color: white; を設定します。color は body や :root ではなく dialog から継承されます。これは予期しない動作である可能性があります。background-color プロパティは継承されません。

理解度をチェックしましょう

ダイアログ要素に関する知識をテストします。

ダイアログの背後にある領域のスタイルを設定するにはどうすればよいですか?

::background 疑似要素を使用する。
もう一度お試しください。
::backdrop 疑似要素を使用する。
正解です。
background プロパティを使用します。
もう一度お試しください。