元素:pointerdown 事件

当指针变为活动状态时,会触发 pointerdown 事件。对于鼠标,当设备从没有按钮按下过渡到至少一个按钮按下时,就会触发它。对于触摸,当与数字化仪发生物理接触时,就会触发它。对于笔,当触笔与数字化仪发生物理接触时,就会触发它。

注意:对于允许直接操作的触摸屏浏览器,pointerdown 事件会触发隐式指针捕获,这会导致目标捕获所有后续的指针事件,就好像它们发生在捕获目标上一样。因此,只要设置了此捕获,pointeroverpointerenterpointerleavepointerout **将不会触发**。可以通过在目标元素上调用element.releasePointerCapture手动释放捕获,或者在 pointeruppointercancel 事件后隐式释放。

语法

在诸如addEventListener()之类的 方法中使用事件名称,或设置事件处理程序属性。

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

onpointerdown = (event) => {};

事件类型

事件属性

此接口继承自MouseEventEvent 的属性。

PointerEvent.altitudeAngle 只读 实验性

表示换能器(指针或触笔)轴线与设备屏幕的 X-Y 平面之间的角度。

PointerEvent.azimuthAngle 只读 实验性

表示 Y-Z 平面与包含换能器(指针或触笔)轴线和 Y 轴的平面之间的角度。

PointerEvent.persistentDeviceId 只读 实验性

生成 PointerEvent 的指向设备的唯一标识符。

PointerEvent.pointerId 只读

导致事件的指针的唯一标识符。

PointerEvent.width 只读

指针接触几何图形在 X 轴上的宽度(大小),以 CSS 像素为单位。

PointerEvent.height 只读

指针接触几何图形在 Y 轴上的高度(大小),以 CSS 像素为单位。

PointerEvent.pressure 只读

指针输入的标准化压力,范围为 01,其中 01 分别表示硬件能够检测到的最小和最大压力。

PointerEvent.tangentialPressure 只读

指针输入的标准化切向压力(也称为桶压力或圆柱应力),范围为 -11,其中 0 是控件的中立位置。

PointerEvent.tiltX 只读

Y–Z 平面与包含指针(例如笔触笔)轴线和 Y 轴的平面之间的平面角(以度为单位,范围为 -9090)。

PointerEvent.tiltY 只读

X–Z 平面与包含指针(例如笔触笔)轴线和 X 轴的平面之间的平面角(以度为单位,范围为 -9090)。

PointerEvent.twist 只读

指针(例如笔触笔)绕其主轴顺时针旋转的角度(以度为单位),取值范围为 0359

PointerEvent.pointerType 只读

指示导致事件的设备类型(鼠标、笔、触摸等)。

PointerEvent.isPrimary 只读

指示指针是否代表此指针类型的首要指针。

示例

使用 addEventListener()

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

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

使用 onpointerdown 事件处理程序属性

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

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

规范

规范
指针事件
# the-pointerdown-event
指针事件
# dom-globaleventhandlers-onpointerdown

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅