大网数据广告活动
Web 标准与前端开发

Element:pointerdown 事件

· 52CE 我爱测

`pointerdown` 事件会在指针变为活动状态时触发。对于鼠标,其会在设备由没有按键按下变为至少有一个按键被按下时触发。对于触控设备,其会在数位板发生物理接触时被触发。对于笔,其会在触控笔与数位板物理接触时触发。

Pointer Events

pointerdown 事件会在指针变为活动状态时触发。对于鼠标,其会在设备由没有按键按下变为至少有一个按键被按下时触发。对于触控设备,其会在数位板发生物理接触时被触发。对于笔,其会在触控笔与数位板物理接触时触发。

此事件的行为不同于 Element/mousedown_event 事件。当使用物理鼠标时,只要鼠标上的任何按键被按下就会触发 mousedown 事件。pointerdown 事件仅在第一个按键被按下时触发,后续按下按键不会触发 pointerdown 事件。

[!NOTE] 对于允许直接操控的触屏浏览器,pointerdown 事件会触发隐式指针捕获,会导致目标捕获后续所有指针事件,就好像这些事件发生在捕获目标上一样。因此,pointerover、pointerenter、pointerleave 和 pointerout 在设置此种捕获后将不再触发。此种捕获可以通过在目标元素上调用 element.releasePointerCapture 手动释放,或者其会在 pointerup 或 pointercancel 事件后被隐式释放。

语法

在 EventTarget.addEventListener 中使用此事件名称:

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

或者,对接口的事件处理器属性赋值:

onpointerdown = (event) => { }

事件类型

PointerEvent。继承自 Event。

PointerEvent

示例

使用 addEventListener():

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

para.addEventListener("pointerdown", (event) => {
  console.log("指针按下事件");
});

使用 onpointerdown 事件处理器属性(但请注意,这会替换掉之前使用 onpointerdown 添加的其他事件监听器,如存在的话):

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

para.onpointerdown = (event) => {
  console.log("指针按下事件");
};

规范

浏览器兼容性

参见

  • 相关事件
    • Element/gotpointercapture_event
    • Element/lostpointercapture_event
    • Element/pointerover_event
    • Element/pointerenter_event
    • Element/pointermove_event
    • Element/pointerup_event
    • Element/pointercancel_event
    • Element/pointerout_event
    • Element/pointerleave_event
    • Element/pointerrawupdate_event
    • Element/mousedown_event

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。