The PointerEvent()
constructor creates a new synthetic and untrusted PointerEvent
object instance.
Syntax
event = new PointerEvent(type, PointerEventInit);
Arguments
- type
- Is a
DOMString
representing the name of the event (see PointerEvent event types). - PointerEventInitOptional
- Is a
PointerEventInit
dictionary, having the following fields:pointerId
— optional and defaulting to0
, of typelong
, that sets the value of the instance'sPointerEvent.pointerId
.width
— optional and defaulting to1
, of typedouble
, that sets the value of the instance'sPointerEvent.width
.height
— optional and defaulting to1
, of typedouble
, that sets the value of the instance'sPointerEvent.height
.pressure
— optional and defaulting to0
, of typefloat
, that sets the value of the instance'sPointerEvent.pressure
.tangentialPressure
— optional and defaulting to0
, of typefloat
, that sets the value of the instance'sPointerEvent.tangentialPressure
.tiltX
— optional and defaulting to0
, of typelong
, that sets the value of the instance'sPointerEvent.tiltX
.tiltY
— optional and defaulting to0
, of typelong
, that sets the value of the instance'sPointerEvent.tiltY
.twist
— optional and defaulting to0
, of typelong
, that sets the value of the instance'sPointerEvent.twist
.pointerType
— optional and defaulting to""
, of typeDOMString
, that sets the value of the instance'sPointerEvent.pointerType
.isPrimary
— optional and defaulting tofalse
, of typeBoolean
, that sets the value of the instance'sPointerEvent.isPrimary
.
Note: The
PointerEventInit
dictionary also accepts fields from theMouseEvent
,UIEventInit
andEventInit
dictionaries.
Example
var moveEvent = new PointerEvent("pointermove"); var downEvent = new PointerEvent("pointerdown", {pointerId: 1, bubbles: true, cancelable: true, pointerType: "touch", width: 100, height: 100, isPrimary: true });
Specifications
Specification | Status | Comment |
---|---|---|
Pointer Events – Level 2 The definition of 'PointerEvent' in that specification. |
Working Draft | Non-stable version. |
Pointer Events The definition of 'PointerEvent' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 55 | 12 | 59 411 | 11 | 42 | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
---|---|---|---|---|---|---|---|
Basic support | 55 | 55 | 12 | No 411 | 42 | No | 6.0 |
1. From version 41: 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.
2. See MSDN Pointer events updates.