PointerEvent: twist property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

The twist read-only property of the PointerEvent interface represents the clockwise rotation of the pointer (e.g., pen stylus) around its major axis, in degrees.

Value

A long value representing the amount of twist, in degrees, applied to the transducer (pointer). The value is in the range 0 to 359, inclusive. For devices that do not report twist, the value is 0.

Examples

When a pointerdown event is fired, different functions are called depending on the value of the event's twist property.

js
someElement.addEventListener(
  "pointerdown",
  (event) => {
    if (event.twist === 0) {
      // No twist
      process_no_twist(event);
    } else {
      // Default
      process_twist(event);
    }
  },
  false,
);

Specifications

Specification
Pointer Events
# dom-pointerevent-twist

Browser compatibility

BCD tables only load in the browser

See also