Skip to content

Conversation

@dipikabh
Copy link
Contributor

Motivation

I came across the ToggleEvent and ToggleEvent.source pages while reviewing #41653 and noticed few opportunities where the text could be improved and made clearer.

I'll leave inline comments to explain some of the specific changes.

@dipikabh dipikabh requested a review from a team as a code owner October 25, 2025 03:10
@dipikabh dipikabh requested review from sideshowbarker and removed request for a team October 25, 2025 03:10
@github-actions github-actions bot added Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed labels Oct 25, 2025
@dipikabh dipikabh requested review from chrisdavidmills and removed request for sideshowbarker October 25, 2025 03:11
@github-actions
Copy link
Contributor

{{APIRef("Popover API")}}

The **`ToggleEvent`** interface represents an event notifying the user an Element's state has changed.
The **`ToggleEvent`** interface represents an event that fires when a popover element is toggled between being shown and hidden.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • might not be accurate to say that the user is notified
  • also added the toggled states to the definition/intro


- {{domxref("ToggleEvent")}}
- : Represents an event notifying the user when a popover element's state toggles between showing and hidden. It is the event object for the {{domxref("HTMLElement.beforetoggle_event", "beforetoggle")}} and {{domxref("HTMLElement.toggle_event", "toggle")}} events, which fire on popovers when their state changes.
- : Represents an event that fires when a popover element is toggled between being shown and hidden. It is the event object for the {{domxref("HTMLElement.beforetoggle_event", "beforetoggle")}} and {{domxref("HTMLElement.toggle_event", "toggle")}} events, which fire on popovers when their state changes.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these changes are purely to align the description here with the intro on the "ToggleEvent" page

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant