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

HTMLElement:toggle 事件

· 52CE 我爱测

HTMLElement 接口的 **`toggle`** 事件会在Popover_API元素、dialog 元素或 details 元素刚刚显示或隐藏后触发。

HTML DOM

HTMLElement 接口的 toggle 事件会在Popover_API元素、dialog 元素或 details 元素刚刚显示或隐藏后触发。

  • 如果元素从隐藏过渡到显示,则 event.oldState 属性会被设置为 closed 而 event.newState 属性会被设置为 open。
  • 如果元素从显示过渡到隐藏,则 event.oldState 会是 open 而 event.newState 会是 closed。

此事件不可取消。

语法

在类似 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。

addEventListener("toggle", (event) => {});

ontoggle = (event) => {};

事件类型

ToggleEvent。继承自 Event。

ToggleEvent

示例

以下示例代码演示了如何使用Popover_API的 toggle 事件。相同的代码也可以相同的方式用于 dialog 或 details 元素。

基础示例

此示例显示了如何监听 toggle 事件并记录结果。

HTML

<button popovertarget="mypopover">打开/关闭弹出框</button>
<div id="mypopover" popover>弹出框的内容</div>
<pre id="log"></pre>
#log {
  height: 150px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}
const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

JavaScript

以下代码为 toggle 事件添加事件处理器,并记录其状态。

const popover = document.getElementById("mypopover");

popover.addEventListener("toggle", (event) => {
  if (event.newState === "open") {
    console.log("已显示弹出框");
  } else {
    console.log("已隐藏弹出框");
  }
});

结果

基础示例

关于 toggle 事件合并的备注

如果在事件循环开始一个循环之前触发了多个 toggle 事件,则只会触发一次事件。这被称为“事件合并”。

例如:

popover.addEventListener("toggle", () => {
  //……
});

popover.showPopover();
popover.hidePopover();
// `toggle` 仅触发一次

其他示例

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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