ToggleEvent

基线 2024

新可用

2024 年 4 月起,此功能可在最新的设备和浏览器版本中使用。此功能可能无法在较旧的设备或浏览器中使用。

ToggleEvent 接口表示一个通知用户元素状态已更改的事件。

它是 HTMLElement beforetoggletoggle 事件的事件对象,这些事件在弹出窗口在显示和隐藏之间转换时触发(分别在之前和之后)。它也是 HTMLDetailsElement toggle 事件的事件对象,该事件在 <details> 元素在打开和关闭之间切换时触发。

Event ToggleEvent

构造函数

ToggleEvent()

创建一个 ToggleEvent 对象。

实例属性

此接口继承其父级 Event 的属性。

ToggleEvent.newState 只读

一个字符串("open""closed"),表示元素正在转换到的状态。

ToggleEvent.oldState 只读

一个字符串("open""closed"),表示元素正在转换自的状态。

示例

基本示例

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

// ...

popover.addEventListener("beforetoggle", (event) => {
  if (event.newState === "open") {
    console.log("Popover is being shown");
  } else {
    console.log("Popover is being hidden");
  }
});

规范

规范
HTML 标准
# toggleevent

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅