Element: pointerdown 事件
當指標變為活動狀態時，會觸發 pointerdown 事件。對於滑鼠，當裝置從沒有按鈕按下變為至少有一個按鈕按下時觸發。對於觸控，當數字轉換器與實體接觸時觸發。對於筆，當觸控筆與數字轉換器實體接觸時觸發。
此行為與 mousedown 事件不同。當使用物理滑鼠時，只要滑鼠上的任何按鈕被按下，就會觸發 mousedown 事件。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 |
瀏覽器相容性
載入中…