Element: beforexrselect event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("WebXR Device API")}}{{SeeCompatTable}}

The **beforexrselect** event is fired before WebXR select events ({{domxref("XRSession/select_event", "select")}}, {{domxref("XRSession/selectstart_event", "selectstart")}}, {{domxref("XRSession/selectend_event", "selectend")}}) are dispatched. It can be used to suppress XR world input events while the user is interacting with a DOM overlay UI.

This event bubbles, is cancelable and is composed.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("beforexrselect", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onbeforexrselect = (event) => { }

Event type

An {{domxref("XRSessionEvent")}}. Inherits from {{domxref("Event")}}.

{{InheritanceDiagram("XRSessionEvent")}}

Event availability

The **beforexrselect** event is a global event and available to the following interfaces:

  • {{domxref("Window")}}
  • {{domxref("Document")}}
  • {{domxref("HTMLElement")}}
  • {{domxref("SVGElement")}}
  • {{domxref("MathMLElement")}}

Examples

To suppress WebXR select events ({{domxref("XRSession/select_event", "select")}}, {{domxref("XRSession/selectstart_event", "selectstart")}}, {{domxref("XRSession/selectend_event", "selectend")}}), an application can listen for the beforexrselect event. The event bubbles, so a call to {{domxref("Event/preventDefault", "preventDefault()")}} on the DOM overlay element will prevent any WebXR select events within this container allowing interaction with the DOM element and avoiding duplicate event input to the XR world.

js
document
  .getElementById("xr-overlay")
  .addEventListener("beforexrselect", (ev) => ev.preventDefault());

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("XRSession/select_event", "select")}} event
  • {{domxref("XRSession/selectstart_event", "selectstart")}} event
  • {{domxref("XRSession/selectend_event", "selectend")}} event
  • {{cssxref(":xr-overlay")}} pseudo-class