HTMLDialogElement: close 事件

Baseline 已广泛支持

此特性已经十分成熟，可在许多设备和浏览器版本上使用。自 2022 年 3 月起，它已在各浏览器中可用。

当 <dialog> 元素被关闭时，会在它所代表的 HTMLDialogElement 对象上触发 close 事件。

此事件不可取消，也不会冒泡。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理程序属性。

addEventListener("close", (event) => { })

onclose = (event) => { }

事件类型

一个通用的 Event。

示例

实时示例

HTML

html

<dialog class="example-dialog">
  <form method="dialog">
    <button>Close via method="dialog"</button>
  </form>
  <button class="close">Close via .close() method</button>
  <p>Or hit the <kbd>Esc</kbd> key</p>
</dialog>

<button class="open-dialog">Open dialog</button>

<div class="result"></div>

button,
div {
  margin: 0.5rem;
}

JavaScript

const result = document.querySelector(".result");

const dialog = document.querySelector(".example-dialog");
dialog.addEventListener("close", (event) => {
  result.textContent = "dialog was closed";
});

const openDialog = document.querySelector(".open-dialog");
openDialog.addEventListener("click", () => {
  dialog.showModal();
  result.textContent = "";
});

const closeButton = document.querySelector(".close");
closeButton.addEventListener("click", () => {
  dialog.close();
});

结果

规范

规范
HTML # event-close

浏览器兼容性

另见

HTML <dialog> 元素
Event 接口

帮助改进 MDN

了解如何贡献

此页面最后于 2025年9月25日由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的错误