HTML DOM
HTMLDialogElement 接口的 showModal() 方法将对话框显示为模态对话框,叠放在其他可能可见的对话框或元素之上。
模态对话框显示在top layer中,并伴随 ::backdrop 伪元素。与对话框位于同一文档中的元素(对话框及其后代除外)会变为惰性(如同指定了 inert 属性)。仅包含该对话框的文档会被阻塞;如果对话框在 iframe 中渲染,页面的其余部分仍可交互。
语法
showModal()
参数
无。
返回值
无(undefined)。
异常
InvalidStateErrorDOMException- : 如果对话框已经以非模态方式打开(即已通过 HTMLDialogElement.show() 打开),则抛出此异常。
示例
基本用法
以下示例展示一个简单按钮:点击后会使用 showModal() 方法打开一个 dialog。
对话框打开时,你无法与页面其余部分交互,包括点击本会触发警告框的触发警告按钮。
你可以点击关闭对话框按钮来关闭对话框(通过 HTMLDialogElement.close() 方法)。
HTML
<dialog id="dialog">
<button type="button" id="close">关闭对话框</button>
</dialog>
<p><button id="open">打开对话框</button></p>
<p><button id="alert">触发警告</button></p>
JavaScript
const dialog = document.getElementById("dialog");
const openButton = document.getElementById("open");
const closeButton = document.getElementById("close");
const alertButton = document.getElementById("alert");
// “打开”按钮打开模态对话框
openButton.addEventListener("click", () => {
dialog.showModal();
});
// “触发警告”按钮触发警告框
alertButton.addEventListener("click", () => {
alert("你点击了我!");
});
// “关闭”按钮关闭对话框
closeButton.addEventListener("click", () => {
dialog.close();
});
结果
基本用法
规范
浏览器兼容性
参见
- HTML dialog 元素
- HTMLDialogElement.show()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
