Firefox Tomorrow

web api event

Element: pointerdown event

View on MDN ↗

The pointerdown event is fired when a pointer becomes active. For mouse, it is fired when the device transitions from no buttons pressed to at least one button pressed. For touch, it is fired when physical contact is made with the digitizer. For pen, it is fired when the stylus makes physical contact with the digitizer.

This behavior is different from mousedown events. When using a physical mouse, mousedown events fire whenever any button on a mouse is pressed down. pointerdown events fire only upon the first button press; subsequent button presses don’t fire pointerdown events.

[!NOTE] For touchscreen browsers that allow direct manipulation, a pointerdown event triggers implicit pointer capture, which causes the target to capture all subsequent pointer events as if they were occurring over the capturing target. Accordingly, pointerover, pointerenter, pointerleave, and pointerout will not fire as long as this capture is set. The capture can be released manually by calling releasePointerCapture on the target element, or it will be implicitly released after a pointerup or pointercancel event.

Syntax

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

addEventListener("pointerdown", (event) => { })

onpointerdown = (event) => { }

Event type

A PointerEvent. Inherits from Event.

Examples

Using addEventListener():

const para = document.querySelector("p");

para.addEventListener("pointerdown", (event) => {
  console.log("Pointer down event");
});

Using the onpointerdown event handler property:

const para = document.querySelector("p");

para.onpointerdown = (event) => {
  console.log("Pointer down event");
};

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also