XRSession.onsqueezestart

The XRSession interface's onsqueezestart event handler property can be set to a function which is then invoked to handle the squeezestart event that's sent when the user successfully begins a primary squeeze action on a WebXR input device. These actions represent the user squeezing or tightly gripping an object or controller.

To learn more about how to use and handle WebXR controller inputs, see Inputs and input sources.

Syntax

xrSession.onsqueezestart = squeezestartHandlerFunction;

Value

A function to be invoked whenever the XRSession receives a squeezestart event.

Examples

This snippet of code adds a simple handler for the squeezestart event, which responds only to events on the user's dominant hand by getting the target ray, then calling a function findObjectUsingRay() to identify the object that the user is pointing at. This object is then stored in a heldObject variable in the user object we're using to represent user information.

xrSession.onsqueezestart = event => {
  if (event.inputSource.handedness == user.handedness) {
    let targetRayPose = event.frame.getPose(event.inputSource.targetRaySpace, myRefSpace;

    if (targetRayPose) {
      user.heldObject = findObjectUsingRay(targetRayPose.transform);
    }
  }
};

Specifications

Browser compatibility

See also

• Inputs and input sources
• The other onsqueeze* handlers: onsqueeze and onsqueezeend
• The squeeze, squeezestart, and squeezeend events