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

Element:pointermove 事件

· 52CE 我爱测

`pointermove` 事件会在指针坐标变化,并且没有被浏览器的触摸动作取消时触发。此事件也会在指针的其他属性变化时触发,但前提是此变化不会产生其他指针事件。此种情况包括指针的压力、侧向压力、倾斜、轴向旋转、接触面(宽度和高度)和组合按键的任何变化。

Pointer Events

pointermove 事件会在指针坐标变化,并且没有被浏览器的触摸动作取消时触发。此事件也会在指针的其他属性变化时触发,但前提是此变化不会产生其他指针事件。此种情况包括指针的压力、侧向压力、倾斜、轴向旋转、接触面(宽度和高度)和组合按键的任何变化。

如果事件循环中存在具有相同指针 ID 的其他未被派发的 pointermove 事件,pointermove 事件可能会被合并。如果事件被合并了,被派发的事件的 target 会与最后一个被合并的事件相同。关于被合并事件的信息,参见 PointerEvent.getCoalescedEvents() 文档。

此事件与 Element/mousemove_event 事件非常相似,但拥有更多特性。此事件无论有无指针按键被按下都会触发。此事件能够以极高的速率触发,取决于用户移动指针的速度、机器的运行速度以及其他正在运行的任务和进程等。

Element/pointerrawupdate_event 与 pointermove 的区别在于它们的触发频率。浏览器可能会推迟 pointermove 事件以改善性能,而 pointerrawupdate 事件则是浏览器能多快频率产生就多快频率派发。对于大多数使用场景,更推荐选择 pointermove 来避免性能问题。

语法

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

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

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

onpointermove = (event) => { }

事件类型

PointerEvent。继承自 Event。

PointerEvent

使用说明

PointerEvent 类型的事件提供了全部你需要知道的关于用户与定点设备交互的信息,包括位置、移动距离、按钮状态等等。

示例

使用 EventTarget.addEventListener 为 pointermove 事件添加一个处理器:

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

para.addEventListener("pointermove", (event) => {
  console.log("指针移动了");
});

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

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

para.onpointermove = (event) => {
  console.log("指针移动了");
};

规范

浏览器兼容性

参见

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

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

资料来源与适用范围

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

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

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