Thepointercancel event is fired when the browser determines that there are unlikely to be any more pointer events, or if after thepointerdown event is fired, the pointer is then used to manipulate the viewport by panning, zooming, or scrolling.

Some examples of situations that will trigger apointercancel event:

• A hardware event occurs that cancels the pointer activities. This may include, for example, the user switching applications using an application switcher interface or the "home" button on a mobile device.
• The device's screen orientation is changed while the pointer is active.
• The browser decides that the user started pointer input accidentally. This can happen if, for example, the hardware supports palm rejection to prevent a hand resting on the display while using a stylus from accidentally triggering events.
• Thetouch-action CSS property prevents the input from continuing.
• When the user interacts with too many simultaneous pointers, the browser can fire this event for all existing pointers (even if the user is still touching the screen).

Syntax

Use the event name in methods likeaddEventListener(), or set an event handler property.

addEventListener("pointercancel", (event) => { })onpointercancel = (event) => { }

Event type

APointerEvent. Inherits fromEvent.

Event properties

This interface inherits properties fromMouseEvent andEvent.

PointerEvent.altitudeAngleRead onlyExperimental

Represents the angle between a transducer (a pointer or stylus) axis and the X-Y plane of a device screen.

PointerEvent.azimuthAngleRead onlyExperimental

Represents the angle between the Y-Z plane and the plane containing both the transducer (a pointer or stylus) axis and the Y axis.

PointerEvent.persistentDeviceIdRead onlyExperimental

A unique identifier for the pointing device generating thePointerEvent.

PointerEvent.pointerIdRead only

A unique identifier for the pointer causing the event.

PointerEvent.widthRead only

The width (magnitude on the X axis), in CSS pixels, of the contact geometry of the pointer.

PointerEvent.heightRead only

The height (magnitude on the Y axis), in CSS pixels, of the contact geometry of the pointer.

PointerEvent.pressureRead only

The normalized pressure of the pointer input in the range0 to1, where0 and1 represent the minimum and maximum pressure the hardware is capable of detecting, respectively.

PointerEvent.tangentialPressureRead only

The normalized tangential pressure of the pointer input (also known as barrel pressure orcylinder stress) in the range-1 to1, where0 is the neutral position of the control.

PointerEvent.tiltXRead only

The plane angle (in degrees, in the range of-90 to90) between the Y–Z plane and the plane containing both the pointer (e.g., pen stylus) axis and the Y axis.

PointerEvent.tiltYRead only

The plane angle (in degrees, in the range of-90 to90) between the X–Z plane and the plane containing both the pointer (e.g., pen stylus) axis and the X axis.

PointerEvent.twistRead only

The clockwise rotation of the pointer (e.g., pen stylus) around its major axis in degrees, with a value in the range0 to359.

PointerEvent.pointerTypeRead only

Indicates the device type that caused the event (mouse, pen, touch, etc.).

PointerEvent.isPrimaryRead only

Indicates if the pointer represents the primary pointer of this pointer type.

Examples

UsingaddEventListener():

const para = document.querySelector("p");para.addEventListener("pointercancel", (event) => {  console.log("Pointer event cancelled");});

Using theonpointercancel event handler property:

const para = document.querySelector("p");para.onpointercancel = (event) => {  console.log("Pointer event cancelled");};

Specifications

Browser compatibility

See also

• Related events
  • gotpointercapture
  • lostpointercapture
  • pointerover
  • pointerenter
  • pointerdown
  • pointermove
  • pointerup
  • pointerout
  • pointerleave
  • pointerrawupdate