元素:touchcancel 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

當一個或多個觸控點以特定於實現的方式中斷時,會觸發 touchcancel 事件。

將觸發 touchcancel 事件的一些情況示例

  • 發生硬體事件,取消了觸控活動。這可能包括,例如,使用者透過應用程式切換器介面或移動裝置上的“主頁”按鈕切換應用程式。
  • 在觸控活動期間更改裝置的螢幕方向。
  • 瀏覽器認為使用者意外啟動了觸控輸入。例如,如果硬體支援掌壓識別,以防止在使用觸控筆時手放在顯示器上意外觸發事件。
  • touch-action CSS 屬性可阻止輸入繼續。
  • 當用戶同時使用過多手指進行互動時,瀏覽器可以為所有現有指標觸發此事件(即使使用者仍接觸螢幕)。

語法

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

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

ontouchcancel = (event) => { }

事件型別

一個 TouchEvent。繼承自 Event

Event UIEvent TouchEvent

事件屬性

此介面繼承自其父介面 UIEventEvent 的屬性。

TouchEvent.altKey 只讀

一個布林值,指示觸發觸控事件時 alt 鍵是否被按下。

TouchEvent.changedTouches 只讀

一個 TouchList,其中包含所有 Touch 物件,這些物件代表了在之前的觸控事件和當前事件之間狀態發生變化的個人接觸點。

TouchEvent.ctrlKey 只讀

一個布林值,指示觸發觸控事件時 control 鍵是否被按下。

TouchEvent.metaKey 只讀

一個布林值,指示觸發觸控事件時 meta 鍵是否被按下。

TouchEvent.shiftKey 只讀

一個布林值,指示觸發觸控事件時 shift 鍵是否被按下。

TouchEvent.targetTouches 只讀

一個 TouchList,包含所有當前與觸控表面接觸的 Touch 物件,並且這些物件也是在與事件目標相同的元素上開始觸控的。

TouchEvent.touches 只讀

一個 TouchList,包含所有表示與表面接觸點的 Touch 物件,無論其目標或變化狀態如何。

TouchEvent.rotation 非標準 只讀

自事件開始以來的旋轉變化(以度為單位)。正值表示順時針旋轉;負值表示逆時針旋轉。初始值:0.0

TouchEvent.scale 非標準 只讀

自事件開始以來兩個手指之間的距離。表示為初始手指距離的浮點數倍。小於 1.0 的值表示向內捏合(縮小)。大於 1.0 的值表示向外張開(放大)。初始值:1.0

示例

這些事件的程式碼示例可在專用頁面上找到:觸控事件

規範

規範
觸控事件
# event-touchcancel
觸控事件
# dom-globaleventhandlers-ontouchcancel

瀏覽器相容性