大网数据广告活动
Web 标准与前端开发

HTMLDialogElement:showModal() 方法

· 52CE 我爱测

HTMLDialogElement 接口的 **`showModal()`** 方法将对话框显示为模态对话框,叠放在其他可能可见的对话框或元素之上。

HTML DOM

HTMLDialogElement 接口的 showModal() 方法将对话框显示为模态对话框,叠放在其他可能可见的对话框或元素之上。

模态对话框显示在top layer中,并伴随 ::backdrop 伪元素。与对话框位于同一文档中的元素(对话框及其后代除外)会变为惰性(如同指定了 inert 属性)。仅包含该对话框的文档会被阻塞;如果对话框在 iframe 中渲染,页面的其余部分仍可交互。

语法

showModal()

参数

无。

返回值

无(undefined)。

异常

  • InvalidStateError DOMException
    • : 如果对话框已经以非模态方式打开(即已通过 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。