元素:touchcancel 事件
當一個或多個觸控點以特定於實現的方式中斷時,會觸發 touchcancel 事件。
將觸發 touchcancel 事件的一些情況示例
- 發生硬體事件,取消了觸控活動。這可能包括,例如,使用者透過應用程式切換器介面或移動裝置上的“主頁”按鈕切換應用程式。
- 在觸控活動期間更改裝置的螢幕方向。
- 瀏覽器認為使用者意外啟動了觸控輸入。例如,如果硬體支援掌壓識別,以防止在使用觸控筆時手放在顯示器上意外觸發事件。
touch-actionCSS 屬性可阻止輸入繼續。- 當用戶同時使用過多手指進行互動時,瀏覽器可以為所有現有指標觸發此事件(即使使用者仍接觸螢幕)。
語法
在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。
js
addEventListener("touchcancel", (event) => { })
ontouchcancel = (event) => { }
事件型別
一個 TouchEvent。繼承自 Event。
事件屬性
此介面繼承自其父介面 UIEvent 和 Event 的屬性。
TouchEvent.altKey只讀-
一個布林值,指示觸發觸控事件時 alt 鍵是否被按下。
TouchEvent.changedTouches只讀-
一個
TouchList,其中包含所有Touch物件,這些物件代表了在之前的觸控事件和當前事件之間狀態發生變化的個人接觸點。 TouchEvent.ctrlKey只讀-
一個布林值,指示觸發觸控事件時 control 鍵是否被按下。
TouchEvent.metaKey只讀-
一個布林值,指示觸發觸控事件時 meta 鍵是否被按下。
TouchEvent.shiftKey只讀-
一個布林值,指示觸發觸控事件時 shift 鍵是否被按下。
TouchEvent.targetTouches只讀-
一個
TouchList,包含所有當前與觸控表面接觸的Touch物件,並且這些物件也是在與事件目標相同的元素上開始觸控的。 TouchEvent.touches只讀TouchEvent.rotation非標準 只讀-
自事件開始以來的旋轉變化(以度為單位)。正值表示順時針旋轉;負值表示逆時針旋轉。初始值:
0.0。 TouchEvent.scale非標準 只讀-
自事件開始以來兩個手指之間的距離。表示為初始手指距離的浮點數倍。小於 1.0 的值表示向內捏合(縮小)。大於 1.0 的值表示向外張開(放大)。初始值:
1.0。
示例
這些事件的程式碼示例可在專用頁面上找到:觸控事件。
規範
| 規範 |
|---|
| 觸控事件 # event-touchcancel |
| 觸控事件 # dom-globaleventhandlers-ontouchcancel |
瀏覽器相容性
載入中…