PointerEvent: PointerEvent() constructor
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.
* Some parts of this feature may have varying levels of support.
The PointerEvent() constructor creates a new synthetic
and untrusted PointerEvent object instance.
Syntax
new PointerEvent(type)
new PointerEvent(type, options)
Parameters
type-
A string representing the name of the event (see PointerEvent event types).
optionsOptional-
An object that, in addition of the properties defined in
MouseEvent(), can have the following properties:pointerId-
A number, defaulting to
0, that sets the value of the instance'sPointerEvent.pointerId. width-
A number, defaulting to
1, that sets the value of the instance'sPointerEvent.width. height-
A number, defaulting to
1, that sets the value of the instance'sPointerEvent.height. pressure-
A number, defaulting to
0, that sets the value of the instance'sPointerEvent.pressure. tangentialPressure-
A number, defaulting to
0, that sets the value of the instance'sPointerEvent.tangentialPressure. altitudeAngle-
A number that sets the value of the instance's
PointerEvent.altitudeAngle. azimuthAngle-
A number that sets the value of the instance's
PointerEvent.azimuthAngle. tiltX-
A number that sets the value of the instance's
PointerEvent.tiltX. tiltY-
A number that sets the value of the instance's
PointerEvent.tiltY. twist-
A number, defaulting to
0, that sets the value of the instance'sPointerEvent.twist. pointerType-
A string, defaulting to
""that sets the value of the instance'sPointerEvent.pointerType. isPrimary-
A boolean value, defaulting to
falsethat sets the value of the instance'sPointerEvent.isPrimary.
Return value
A new PointerEvent object.
Examples
const moveEvent = new PointerEvent("pointermove");
const downEvent = new PointerEvent("pointerdown", {
pointerId: 1,
bubbles: true,
cancelable: true,
pointerType: "touch",
width: 100,
height: 100,
isPrimary: true,
});
Specifications
| Specification |
|---|
| Pointer Events # dom-pointerevent-constructor |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
PointerEvent() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
options.altitudeAngle parameter
|
|
|
|
|
|
|
|
|
|
|
|
|
options.azimuthAngle parameter
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support