ToggleEvent

Baseline 2023
新推出

自 ⁨2023 年 11 月⁩ 起,此功能可在最新的裝置和瀏覽器版本中執行。此功能可能不適用於較舊的裝置或瀏覽器。

ToggleEvent 介面表示一個事件,用於通知使用者某個元素的狀態已更改。

這是 HTMLElementbeforetoggletoggle 事件的事件物件,它們分別在某些元素顯示和隱藏之間過渡之前和之後觸發。

Event ToggleEvent

建構函式

ToggleEvent()

建立一個 ToggleEvent 物件。

例項屬性

此介面繼承了其父介面 Event 的屬性。

ToggleEvent.newState 只讀

一個字串(可以是 "open""closed"),表示元素正在轉換到的狀態

ToggleEvent.oldState 只讀

一個字串(可以是 "open""closed"),表示元素正在從中轉換的狀態

ToggleEvent.source 只讀

一個 Element 物件例項,表示觸發切換的 HTML 控制元件。

示例

基本示例

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

瀏覽器相容性

另見