Add popover documentation for methods, events, and psuedo selectors

[keithamus]

Description

This adds more documentation related to popover. Most of the specifications for which can be found here: https://html.spec.whatwg.org/multipage/popover.html.

Motivation

This feature is currently not documented. This follows on from #25961 which added the initial links to various pages.

Additional details

Related issues and pull requests

#25125

[github-actions]

Preview URLs (8 pages)

• /en-US/docs/Web/API/HTMLElement/beforetoggle_event
• /en-US/docs/Web/API/HTMLElement/hidePopover
• /en-US/docs/Web/API/HTMLElement/showPopover
• /en-US/docs/Web/API/HTMLElement/togglePopover
• /en-US/docs/Web/API/HTMLElement/toggle_event
• /en-US/docs/Web/API/ToggleEvent
• /en-US/docs/Web/CSS/:popover-open
• /en-US/docs/Web/HTML/Global_attributes/popover

Flaws (11)

Note! 3 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/HTML/Global_attributes/popover
Title: popover
Flaw count: 2

• broken_links:
  • Can't resolve /en-US/docs/Web/HTML/button#popovertarget
  • Can't resolve /en-US/docs/Web/API/HTMLElement/showPopover/

---

URL: /en-US/docs/Web/API/ToggleEvent
Title: ToggleEvent
Flaw count: 4

• macros:
  • /en-US/docs/Web/API/ToggleEvent/ToggleEvent does not exist
  • /en-US/docs/Web/API/ToggleEvent/oldState does not exist
  • /en-US/docs/Web/API/ToggleEvent/newState does not exist
• bad_bcd_queries:
  • No BCD data for query: api.ToggleEvent

---

URL: /en-US/docs/Web/API/HTMLElement/beforetoggle_event
Title: HTMLElement: beforetoggle event
Flaw count: 2

• macros:
  • /en-US/docs/Web/API/ToggleEvent/oldState does not exist
  • /en-US/docs/Web/API/ToggleEvent/newState does not exist

---

URL: /en-US/docs/Web/API/HTMLElement/toggle_event
Title: HTMLElement: toggle event
Flaw count: 2

• macros:
  • /en-US/docs/Web/API/ToggleEvent/oldState does not exist
  • /en-US/docs/Web/API/ToggleEvent/newState does not exist

---

URL: /en-US/docs/Web/CSS/:popover-open
Title: :popover-open
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: css.selectors.popover-open

External URLs (1)

URL: /en-US/docs/Web/HTML/Global_attributes/popover
Title: popover

• https://github.com/oddbird/popover-polyfill (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2023-04-14 13:40:19)

[chrisdavidmills]

@keithamus Hey there Keith! This is amazing: I was just starting to document the popover API when I noticed that you had done most of it already ;-)

Question — there are still a few bits of this API that could still do with documenting. Are you intending to do any more work on this, or shall I just jump in and get it finished off? I was thinking of creating a landing page for the overall API, pages for popovertarget and popovertargetaction, etc.

[keithamus]

@chrisdavidmills I'll still be doing more. I intend to document popovertarget & popovertargetaction, as well as refining the existing work I've done. I considered a landing page - but perhaps I'll leave that one for you to work on 😝

[chrisdavidmills]

@keithamus nice one, it'll be great to work alongside you. In case it helps, here is my research doc where I've looked into all the stuff that needs to be documented: https://docs.google.com/document/d/1ryC_4hvkLom0E7aaNnAB82_Ki5Rb_cKgrOJGSBU9fuw/edit# (you've done most of them, but there are a few more to do)

It would be good to have example code for all these pages as well.

I tested all the features today and noted down that everything seemed to be working.

I am happy to write the landing page. I'll start work on that tomorrow. I can also update the browser compact data if you like, to include anything that's missing.