元素:pointerenter 事件

当指向设备移动到元素或其后代的命中测试边界内时,会触发 pointerenter 事件,包括作为不支持悬停的设备的 pointerdown 事件的结果(参见 pointerdown)。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

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

onpointerenter = (event) => {};

事件类型

事件属性

此接口继承自 MouseEventEvent 的属性。

PointerEvent.altitudeAngle 只读 实验性

表示换能器(指针或手写笔)轴与设备屏幕的 X-Y 平面之间的角度。

PointerEvent.azimuthAngle 只读 实验性

表示换能器(指针或触笔)轴线与 Y 轴所构成的平面与 Y-Z 平面的夹角。

PointerEvent.persistentDeviceId 只读 实验性

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

PointerEvent.pointerId 只读

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

PointerEvent.width 只读

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

PointerEvent.height 只读

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

PointerEvent.pressure 只读

指针输入的标准化压力,范围为 01,其中 01 分别表示硬件能够检测到的最小和最大压力。

PointerEvent.tangentialPressure 只读

指针输入的标准化切向压力(也称为桶形压力或圆柱体应力),范围为 -11,其中 0 是控件的中立位置。

PointerEvent.tiltX 只读

指针(例如笔触笔)轴线与 Y 轴所构成的平面与 Y-Z 平面的平面角(以度为单位,范围为 -9090)。

PointerEvent.tiltY 只读

指针(例如笔触笔)轴线与 X 轴所构成的平面与 X-Z 平面的平面角(以度为单位,范围为 -9090)。

PointerEvent.twist 只读

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

PointerEvent.pointerType 只读

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

PointerEvent.isPrimary 只读

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

示例

使用 addEventListener()

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

para.addEventListener("pointerenter", (event) => {
  console.log("Pointer entered element");
});

使用 onpointerenter 事件处理程序属性

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

para.onpointerenter = (event) => {
  console.log("Pointer entered element");
};

规范

规范
指针事件
# the-pointerenter-event
指针事件
# dom-globaleventhandlers-onpointerenter

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅