pointerdown

Summary

Dispatched when a pointer enters the state of having a non-zero value for the buttons property.

Overview Table

Synchronous	Yes
Bubbles	Yes
Target	dom/Element
Cancelable	Yes
Default action	Varies: when the pointer is primary, all default actions of the [mousedown](/dom/MouseEvent/mousedown) event

For mouse, this is when the device has at least one button depressed. For touch, this is when there is physical contact with the digitizer. For pen, this is when the pen has physical contact with the digitizer.

For input devices that do not support hover, the user agent also fires a pointerover event preceding the pointerdown event.

Examples

element.addEventListener("pointerdown", handler, useCapture)

Notes

Some pointer devices, such as mouse or pen, support multiple buttons. In the DOM Level 3 Events Mouse Event model, each button press produces a mousedown and mouseup event.

Pointer Events do not fire overlapping pointerdown and pointerup events when an additional button is depressed while another button on the pointer device is already depressed. For detecting these cases, see Chorded Button Interactions in the PointerEvents specification.

Related specifications

Pointer Events

Working Draft

Attributions

• Microsoft Developer Network: [pointerdown Event Article]