ToggleEvent

Baseline 2025
Newly available

Since January 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

ToggleEvent インターフェイスは、ポップオーバー要素の状態が表示と非表示の間で切り替わるときにユーザーに通知するイベントを表します。

これは HTMLElementbeforetoggle および toggle イベントのためのイベントオブジェクトであり、表示中と非表示の間で遷移したときに(それぞれ前と後に)ポップオーバーで発行されます。

Event ToggleEvent

メモ: ToggleEventHTMLDetailsElementtoggle イベントとは関係ありません。こちらは <details> において、open/closed の状態が変化したときに発生します。こちらのイベントオブジェクトは一般的な Event です。

コンストラクター

ToggleEvent() Experimental

ToggleEvent オブジェクトを作成します。

インスタンスプロパティ

このインターフェイスは、親である Event からプロパティを継承しています。

ToggleEvent.newState 読取専用 Experimental

"open" または "closed"の)文字列で、要素が遷移した後の状態を表します。

ToggleEvent.oldState 読取専用 Experimental

"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");
  }
});

仕様書

Specification
HTML
# toggleevent

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ToggleEvent
ToggleEvent() constructor
newState
oldState

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報