元素:gotpointercapture 事件
gotpointercapture
事件在元素使用 setPointerCapture()
捕获指针时触发。
语法
在像 addEventListener()
这样的方法中使用事件名称,或者设置事件处理程序属性。
addEventListener("gotpointercapture", (event) => {});
ongotpointercapture = (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
只读-
指示指针是否代表此指针类型的首要指针。
示例
此示例获取一个 <p>
元素并监听 gotpointercapture
事件。然后,它在 pointerdown
事件上对元素调用 setPointerCapture()
,这将触发 gotpointercapture
。
const para = document.querySelector("p");
para.addEventListener("gotpointercapture", () => {
console.log("I've been captured!");
});
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
相同的示例,使用 ongotpointercapture
事件处理程序属性
const para = document.querySelector("p");
para.ongotpointercapture = () => {
console.log("I've been captured!");
};
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
规范
规范 |
---|
指针事件 # the-gotpointercapture-event |
指针事件 # dom-globaleventhandlers-ongotpointercapture |
浏览器兼容性
BCD 表仅在浏览器中加载