GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • MDN
  • HTML: Markup language
  • Elements
  • Global attributes
  • Attributes
  • See all…
  • Responsive images
  • HTML cheatsheet
  • Date & time formats
  • See all…
  • SVG
  • MathML
  • XML
  • CSS: Styling language

This view

  • Original page
  • New address

GeezerVison is showing developer.mozilla.org — ToggleEvent - Web APIs | MDN

ToggleEvent

Baseline
Widely available
*

This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2023.

* Some parts of this feature may have varying levels of support.

  • See full compatibility
  • Learn more

The ToggleEvent interface represents an event that fires when a popover element is toggled between being shown and hidden.

This is the event object for the beforetoggle and toggle events, which fire on elements as follows:

  • The beforetoggle event fires before popover or <dialog> elements are shown or hidden.
  • The toggle event fires after popover, <dialog>, or <details> elements are shown or hidden.

Constructor

ToggleEvent()

Creates a ToggleEvent object.

Instance properties

This interface inherits properties from its parent, Event.

ToggleEvent.newState Read only

A string (either "open" or "closed"), representing the state the element is transitioning to.

ToggleEvent.oldState Read only

A string (either "open" or "closed"), representing the state the element is transitioning from.

ToggleEvent.source Read only

An Element object instance representing the HTML control that initiated the toggle.

Examples

Basic example

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

Specifications

Specification
HTML
# toggleevent

Browser compatibility

See also

  • Popover API
  • beforetoggle event
  • toggle event

Help improve MDN

Learn how to contribute

This page was last modified on Oct 27, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.