<dialog>

HTML <dialog> 要素は、ダイアログボックスやインスペクターやウィンドウのようなそのほかのインタラクティブコンポーネントを表します。method="dialog"属性を指定することで、ダイアログ<form>要素を統合できます。このようなフォームが送信されたとき、returnValue属性が送信ボタンの値に設定されて閉じられます。

::backdropCSS擬似セレクタを<dialog>要素のスタイルとして使用できます。たとえば、モーダルダイアログがアクティブになっている時に、アクセスできない背景を暗くする場合に使用します。

属性

この要素はグローバル属性を含みます。tabindex属性を<dialog>要素で使用してはいけません。

open

ダイアログがアクティブで操作で使用できることを示します。open属性が設定されていないときは、ユーザーに表示されません。

例

例 1

<dialog open>
  <p>Greetings, one and all!</p>
</dialog>

例 2

<!-- Simple pop-up dialog box, containing a form -->
<dialog id="favDialog">
  <form method="dialog">
    <section>
      <p><label for="favAnimal">Favorite animal:</label>
      <select id="favAnimal" name="favAnimal">
        <option></option>
        <option>Brine shrimp</option>
        <option>Red panda</option>
        <option>Spider monkey</option>
      </select></p>
    </section>
    <menu>
      <button id="cancel" type="reset">Cancel</button>
      <button type="submit">Confirm</button>
    </menu>
  </form>
</dialog>

<menu>
  <button id="updateDetails">Update details</button>
</menu>

<script>
  (function() {
    var updateButton = document.getElementById('updateDetails');
    var cancelButton = document.getElementById('cancel');
    var favDialog = document.getElementById('favDialog');

    // Update button opens a modal dialog
    updateButton.addEventListener('click', function() {
      favDialog.showModal();
    });

    // Form cancel button closes the dialog box
    cancelButton.addEventListener('click', function() {
      favDialog.close();
    });

  })();
</script>

仕様

ブラウザ実装状況

[1] See バグ 840640.

関連項目

• The close event
• The cancel event
• HTML forms guide.