Back to Content

PointerEvent: twist property

files/en-us/web/api/pointerevent/twist/index.md

latest934 B
Original Source

{{ APIRef("Pointer Events") }}

The twist read-only property of the {{domxref("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 {{domxref("Element/pointerdown_event", "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);
  }
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{ domxref("Touch.force") }}