HTMLDialogElement: show() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年3月以降、すべてのブラウザーで利用可能です。

もっと詳しく
完全な互換性情報を見る

show() は HTMLDialogElement インターフェイスのメソッドで、ダイアログをモードレスに表示します。すなわち、ダイアログの外側のコンテンツも操作できる状態にします。

構文

show()

引数

なし。

返値

なし (undefined)。

例外

InvalidStateError DOMException: ダイアログが既に開いておりモーダルである場合(つまり、すでに HTMLDialogElement.showModal() で開かれている場合)、例外が発生します。

例

次の例は単純なボタンで、クリックするとフォームを含むダイアログ (<dialog>) を show() メソッドで開きます。ここから、Cancel ボタンをクリックしてダイアログを閉じたり(HTMLDialogElement.close() メソッドで)、submit ボタンでフォームを送信したりすることができます。

html

<!-- フォームを含む単純なポップアップダイアログボックス -->
<dialog id="favDialog">
 <form method="dialog">
 <section>
 <p>
 <label for="favAnimal">好きな動物:</label>
 <select id="favAnimal" name="favAnimal">
 <option></option>
 <option>ブラインシュリンプ</option>
 <option>レッサーパンダ</option>
 <option>クモザル</option>
 </select>
 </p>
 </section>
 <menu>
 <button id="cancel" type="reset">キャンセル</button>
 <button type="submit">確認</button>
 </menu>
 </form>
</dialog>
<menu>
 <button id="updateDetails">詳細を更新</button>
</menu>

const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favDialog");
dialog.returnValue = "favAnimal";
function openCheck(dialog) {
 if (dialog.open) {
 console.log("Dialog open");
 } else {
 console.log("Dialog closed");
 }
}
// 更新ボタンでモーダルダイアログを開く
updateButton.addEventListener("click", () => {
 dialog.show();
 openCheck(dialog);
});
// フォームのキャンセルボタンでダイアログボックスを閉じる
cancelButton.addEventListener("click", () => {
 dialog.close("animalNotChosen");
 openCheck(dialog);
});

仕様書

仕様書
HTML # dom-dialog-show-dev

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって 2025年9月20日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告