Element:pointerleave 事件

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2020 年 7 月以來,它已在各大瀏覽器中可用。

當定點裝置移出元素的命中測試邊界時,將觸發 pointerleave 事件。對於筆式裝置,當手寫筆離開數字化儀可檢測到的懸停範圍時,會觸發此事件。在其他情況下,pointerleave 的工作方式與 mouseleave 相同,並且會同時派發。如果適用,它們也會與 mouseoutpointerout 事件同時派發。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("pointerleave", (event) => { })

onpointerleave = (event) => { }

事件型別

一個 PointerEvent。繼承自 Event

Event UIEvent MouseEvent PointerEvent

事件屬性

此介面繼承自 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 只讀

指示此指標是否表示此指標型別的主要指標。

示例

使用 addEventListener()

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

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

使用 onpointerleave 事件處理程式屬性

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

para.onpointerleave = (event) => {
  console.log("Pointer left element");
};

規範

規範
指標事件
# the-pointerleave-event
指標事件
# dom-globaleventhandlers-onpointerleave

瀏覽器相容性

另見