HTMLDialogElement: show() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2022年3月以降、すべてのブラウザーで利用可能です。
show() は HTMLDialogElement インターフェイスのメソッドで、ダイアログをモードレスに表示します。すなわち、ダイアログの外側のコンテンツも操作できる状態にします。
構文
js
show()
引数
なし。
返値
なし (undefined)。
例外
InvalidStateErrorDOMException-
ダイアログが既に開いておりモーダルである場合（つまり、すでに
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>
js
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 |
ブラウザーの互換性
関連情報
- このインターフェイスを実装している HTML 要素:
<dialog>