Document global beforexrselect event

[Elchi3]

This is a PR to discuss how to document events that are defined as GlobalEventHandlers.

Spec: https://immersive-web.github.io/dom-overlays/#onbeforexrselect

WebIDL:

partial interface mixin GlobalEventHandlers {
  attribute EventHandler onbeforexrselect;
};

Document includes GlobalEventHandlers
Window includes GlobalEventHandlers
HTMLElement includes GlobalEventHandlers
MathMLElement includes GlobalEventHandlers
SVGElement includes GlobalEventHandlers

If we would avoid the GlobalEventHandlers mixin, then the specific interfaces for the beforexrselect event would be Document, Window, HTMLElement, MathMLElement, SVGElement. I think it makes no sense to create pages under all these interfaces. So, here I'm instead creating a single page beforexrselect_event under GlobalEventHandlers along with a section on the page called "Event availability". The title of the page is just 'beforexrselect event' without an interface.

In BCD, the data would live in api.GlobalEventHandlers.beforexrselect_event. See mdn/browser-compat-data#16026

[github-actions]

Preview URLs

• https://pr15376.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/GlobalEventHandlers/beforexrselect_event
• https://pr15376.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/XRSession/domOverlayState
• https://pr15376.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/XRSession/select_event
• https://pr15376.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/XRSession/selectend_event
• https://pr15376.content.dev.mdn.mozit.cloud/en-US/docs/Web/API/XRSession/selectstart_event

Flaws

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

URL: /en-US/docs/Web/API/GlobalEventHandlers/beforexrselect_event
Title: beforexrselect event
on GitHub
Flaw count: 1

• bad_bcd_queries:
  • No BCD data for query: api.GlobalEventHandlers.beforexrselect_event

External URLs

URL: /en-US/docs/Web/API/GlobalEventHandlers/beforexrselect_event
Title: beforexrselect event
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/XRSession/domOverlayState
Title: XRSession.domOverlayState
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/XRSession/selectend_event
Title: XRSession: selectend event
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/XRSession/select_event
Title: XRSession: select event
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/API/XRSession/selectstart_event
Title: XRSession: selectstart event
on GitHub

No new external URLs

[Elchi3]

So this wants to move XRSession.onbeforexrselect to GlobalEventHandlers?

I don't see XRSession.onbeforexrselect anywhere. Can you elaborate? I think it has always been on GlobalEventHandlers.

[saschanaz]

I don't see XRSession.onbeforexrselect anywhere. Can you elaborate? I think it has always been on GlobalEventHandlers.

Oh, I misunderstood then. Sorry.

[foolip]

The target of this event is an Element and it bubbles, so I think we should have this event under Element and perhaps redirect for Document and Window.

[Elchi3]

The target of this event is an Element and it bubbles, so I think we should have this event under Element and perhaps redirect for Document and Window.

I believe this is what I should do now given GEH pages are gone.

[Elchi3]

Closing this in favor of #19698 where I document this event under Element per @foolip's suggestion.