PointerEvent.twist

The twist read-only property of the PointerEvent interface represents the clockwise rotation of the transducer (e.g. pen stylus) around its major axis in degrees, with a value in the range 0 to 359.

For devices that do not report twist, the value MUST be 0.

Syntax

var twist = pointerEvent.twist;

Value

A long value representing the amount of twist applied to the pointer.

Example

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

someElement.addEventListener('pointerdown', function(ev) {
   if (ev.twist == 0) {
     // No twist
     process_no_twist(ev);
   } else {
     // Default
     process_twist(ev);
   }
 }, false);

Specifications

Specification Status Comment
Pointer Events – Level 2
The definition of 'twist' in that specification.
Editor's Draft  

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support58 No

No

541

No45 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support5858 No

No

541

No45 No

1. From version 54: this feature is behind the dom.w3c_pointer_events.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

 Contributors to this page: lpd-au, jpmedley, chrisdavidmills
 Last updated by: lpd-au,