用途:为单指针直接操作交互建立明确的运行时契约:从 pointerdown 开始到提交、取消或销毁,同一时刻只有一个活动 pointerId,并明确 idle、previewing、committed、cancelled 状态。适用于拖拽、缩放柄、滑块、画布工具、滑动等场景。
主要能力:核查起点与活动指针、事件投递路径(元素捕获、window 捕获阶段、document/window 监听)、pointerup/pointercancel/lostpointercapture 的终态处理、buttons === 0 的恢复证据、活动 pointerId 守卫、touch-action 轴选择、幂等销毁与状态清理;并区分提交、回退与取消语义。提供快速探测法与真实浏览器回归建议(鼠标、触摸、笔),记录终止原因、最终值与捕获状态。
使用方式:先记录 pointerId、pointerType、事件类型、button、buttons、活动所有者与 hasPointerCapture,再按事件路径定位丢失点;选择最小修复(元素捕获或全局捕获路径),保留未被替代的浏览器平移缩放;在手势开始前配置 touch-action,并验证真实滚动缩放行为;销毁时移除非声明式监听、清空状态、尽量释放捕获。
限制:不负责多指捏合、旋转等真正多指几何与状态系统;不负责 HTML 拖放与文件上传、键盘可达性与通用点击、用户激活(transient activation)、INP 性能、页面生命周期恢复。模拟触摸或笔不等同于物理设备证据;取消/提交契约未定义时应说明验证缺口,不得当作已确认修复。