指针事件检测器 - 鼠标/触控笔/触摸类型区分

Pointer Events API 是W3C制定的统一指针输入标准，它将鼠标、触控笔、触摸等不同输入方式抽象为统一的PointerEvent对象。开发者只需监听一组事件（pointerdown、pointermove、pointerup等），即可处理所有指针输入类型，无需分别处理mousedown和touchstart。通过event.pointerType属性可以区分具体输入设备类型（'mouse'、'pen'、'touch'）。

pointerType 有三种标准值：
· 'mouse' — 鼠标输入，通常没有压力感应（pressure为0或0.5），支持悬停；
· 'pen' — 触控笔/手写笔（如Apple Pencil、Wacom笔、Surface Pen），支持压力感应（pressure 0~1）、倾斜检测（tiltX/tiltY）、悬停等高级特性；
· 'touch' — 手指触摸，不支持悬停，可能提供接触面积（width/height）和粗略压力值。
在pointerdown事件中，pointerType即被确定，后续的move和up事件会保持一致。

pressure 是一个0到1之间的浮点数，表示指针在数字化仪表面上的压力。对于触控笔，0表示笔尖轻触或悬停，1表示最大压力。不同设备压力范围不同（如Apple Pencil支持精细的压力等级）。对于鼠标，按下按钮时通常为0.5，未按下时为0。对于触摸，部分设备支持压力感应（如3D Touch），但多数设备返回0或0.5的离散值。开发者可利用pressure实现可变粗细的绘图、透明度变化等效果。

在移动端使用指针事件时，必须在目标元素上设置CSS属性touch-action: none。这是因为浏览器默认会拦截触摸事件用于滚动、缩放等手势操作。如果不设置此属性，pointermove事件可能在几个事件后被浏览器取消（触发pointercancel），导致轨迹断裂。设置touch-action: none告知浏览器该元素自行处理所有指针事件，不执行默认手势。此外，在pointerdown中调用event.preventDefault()也能帮助防止意外行为。

推荐优先使用Pointer Events。它是更新的标准，统一了所有输入类型，代码更简洁，且支持触控笔的高级特性（压力、倾斜等）。Touch Events是较早的API，仅处理触摸输入，且不提供pointerType区分。如果你的应用需要兼容非常老的浏览器（如IE10及以下），可能需要回退到Touch Events + Mouse Events的组合方案。但对于现代浏览器（覆盖率>97%），Pointer Events是最佳选择。

可通过多种方式检测：
· navigator.maxTouchPoints — 返回设备支持的最大同时触摸点数，>0表示支持触摸；
· window.matchMedia('(pointer: fine)') — 检测是否有精确指针（鼠标或触控笔）；
· window.matchMedia('(pointer: coarse)') — 检测是否有粗略指针（触摸）；
· window.matchMedia('(hover: hover)') — 检测是否支持悬停（鼠标或高级触控笔）；
· 'ontouchstart' in window — 传统触摸检测方式。
但无法仅通过API确定设备是否连接了触控笔——需要在运行时通过pointerType === 'pen'来实际检测。

在支持的设备上（如iPad Pro + Apple Pencil 2代），当笔尖在屏幕上方约12mm范围内悬停时，会触发pointermove事件，此时pressure为0，pointerType为'pen'。开发者可以通过检查pressure === 0且pointerType === 'pen'来判断笔处于悬停状态。这允许实现悬停预览、光标指示等高级交互。此功能需要设备硬件支持（电磁感应悬停检测）。

高刷新率指针设备（如120Hz触控笔）产生的硬件事件频率可能远高于浏览器的JS事件循环频率。浏览器会将多个硬件事件合并为一个JS事件，而event.getCoalescedEvents()方法可以获取被合并的原始事件数组。这对于绘图应用非常重要——使用合并事件可以绘制出更平滑的线条，避免因事件合并导致的折线效果。每个合并事件都包含完整的位置和属性信息。