元素:pointerdown 事件
当指针变为活动状态时,会触发 pointerdown
事件。对于鼠标,当设备从没有按钮按下过渡到至少一个按钮按下时,就会触发它。对于触摸,当与数字化仪发生物理接触时,就会触发它。对于笔,当触笔与数字化仪发生物理接触时,就会触发它。
注意:对于允许直接操作的触摸屏浏览器,pointerdown
事件会触发隐式指针捕获,这会导致目标捕获所有后续的指针事件,就好像它们发生在捕获目标上一样。因此,只要设置了此捕获,pointerover
、pointerenter
、pointerleave
和 pointerout
**将不会触发**。可以通过在目标元素上调用element.releasePointerCapture
手动释放捕获,或者在 pointerup
或 pointercancel
事件后隐式释放。
语法
在诸如addEventListener()
之类的 方法中使用事件名称,或设置事件处理程序属性。
addEventListener("pointerdown", (event) => {});
onpointerdown = (event) => {};
事件类型
一个PointerEvent
。继承自Event
。
事件属性
此接口继承自MouseEvent
和 Event
的属性。
PointerEvent.altitudeAngle
只读 实验性-
表示换能器(指针或触笔)轴线与设备屏幕的 X-Y 平面之间的角度。
PointerEvent.azimuthAngle
只读 实验性-
表示 Y-Z 平面与包含换能器(指针或触笔)轴线和 Y 轴的平面之间的角度。
PointerEvent.persistentDeviceId
只读 实验性-
生成
PointerEvent
的指向设备的唯一标识符。 PointerEvent.pointerId
只读-
导致事件的指针的唯一标识符。
PointerEvent.width
只读-
指针接触几何图形在 X 轴上的宽度(大小),以 CSS 像素为单位。
PointerEvent.height
只读-
指针接触几何图形在 Y 轴上的高度(大小),以 CSS 像素为单位。
PointerEvent.pressure
只读-
指针输入的标准化压力,范围为
0
到1
,其中0
和1
分别表示硬件能够检测到的最小和最大压力。 PointerEvent.tangentialPressure
只读-
指针输入的标准化切向压力(也称为桶压力或圆柱应力),范围为
-1
到1
,其中0
是控件的中立位置。 PointerEvent.tiltX
只读-
Y–Z 平面与包含指针(例如笔触笔)轴线和 Y 轴的平面之间的平面角(以度为单位,范围为
-90
到90
)。 PointerEvent.tiltY
只读-
X–Z 平面与包含指针(例如笔触笔)轴线和 X 轴的平面之间的平面角(以度为单位,范围为
-90
到90
)。 PointerEvent.twist
只读-
指针(例如笔触笔)绕其主轴顺时针旋转的角度(以度为单位),取值范围为
0
到359
。 PointerEvent.pointerType
只读-
指示导致事件的设备类型(鼠标、笔、触摸等)。
PointerEvent.isPrimary
只读-
指示指针是否代表此指针类型的首要指针。
示例
使用 addEventListener()
const para = document.querySelector("p");
para.addEventListener("pointerdown", (event) => {
console.log("Pointer down event");
});
使用 onpointerdown
事件处理程序属性
const para = document.querySelector("p");
para.onpointerdown = (event) => {
console.log("Pointer down event");
};
规范
规范 |
---|
指针事件 # the-pointerdown-event |
指针事件 # dom-globaleventhandlers-onpointerdown |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。