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` 仅触发一次
其他示例
HTMLDialogElement中的打开模态框示例
规范
浏览器兼容性
参见
popoverHTML 全局属性- 弹出框 API
- 相关事件:
beforetoggle
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
