元素:gotpointercapture 事件

gotpointercapture 事件在元素使用 setPointerCapture() 捕获指针时触发。

语法

在像 addEventListener() 这样的方法中使用事件名称,或者设置事件处理程序属性。

js
addEventListener("gotpointercapture", (event) => {});

ongotpointercapture = (event) => {};

事件类型

事件属性

此接口继承了 MouseEventEvent 的属性。

PointerEvent.altitudeAngle 只读 实验性

表示传感器(指针或触控笔)轴线与设备屏幕的 X-Y 平面之间的角度。

PointerEvent.azimuthAngle 只读 实验性

表示 Y-Z 平面与包含传感器(指针或触控笔)轴线和 Y 轴的平面之间的角度。

PointerEvent.persistentDeviceId 只读 实验性

生成 PointerEvent 的指向设备的唯一标识符。

PointerEvent.pointerId 只读

导致事件的指针的唯一标识符。

PointerEvent.width 只读

指针接触几何形状的宽度(X 轴上的大小),以 CSS 像素为单位。

PointerEvent.height 只读

指针接触几何形状的高度(Y 轴上的幅度),以 CSS 像素为单位。

PointerEvent.pressure 只读

指针输入的归一化压力,范围在 01 之间,其中 01 分别代表硬件能够检测到的最小和最大压力。

PointerEvent.tangentialPressure 只读

指针输入的归一化切向压力(也称为桶压力或 圆柱应力),范围在 -11 之间,其中 0 是控件的中性位置。

PointerEvent.tiltX 只读

Y-Z 平面与包含指针(例如笔触笔)轴和 Y 轴的平面之间的平面角(以度为单位,范围为 -9090)。

PointerEvent.tiltY 只读

X-Z 平面与包含指针(例如笔触笔)轴和 X 轴的平面之间的平面角(以度为单位,范围为 -9090)。

PointerEvent.twist 只读

指针(例如笔触笔)绕其主轴的顺时针旋转角度(以度为单位),其值在 0359 之间。

PointerEvent.pointerType 只读

指示导致事件的设备类型(鼠标、笔、触摸等)。

PointerEvent.isPrimary 只读

指示指针是否代表此指针类型的首要指针。

示例

此示例获取一个 <p> 元素并监听 gotpointercapture 事件。然后,它在 pointerdown 事件上对元素调用 setPointerCapture(),这将触发 gotpointercapture

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

para.addEventListener("gotpointercapture", () => {
  console.log("I've been captured!");
});

para.addEventListener("pointerdown", (event) => {
  para.setPointerCapture(event.pointerId);
});

相同的示例,使用 ongotpointercapture 事件处理程序属性

js
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 表仅在浏览器中加载

另请参阅