Element: touchcancel イベント

touchcancel イベントは、1 つ以上のタッチポイントが実装固有の理由で中断されたとき(例えば、タッチポイントが多すぎるとき)に発生します。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js

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

ontouchcancel = (event) => {};

イベント型

TouchEvent です。 Event を継承しています。

Event UIEvent TouchEvent

イベントプロパティ

このインターフェイスは UIEvent および Event からプロパティを継承しています。

TouchEvent.altKey (en-US) 読取専用

論理値で、タッチイベントが発行されたときに alt キーが押されていたかどうかを示します。

TouchEvent.changedTouches (en-US) 読取専用

前回のタッチイベントと今回のタッチイベントの間で状態が変化した、個々の接点を表すすべての Touch オブジェクトの TouchList です。

TouchEvent.ctrlKey (en-US) 読取専用

論理値で、タッチイベントが発行されたときにコントロールキーが押されていたかどうかを示します。

TouchEvent.metaKey (en-US) 読取専用

論理値で、タッチイベントが発行されたときにメタキーが押されていたかどうかを示します。

TouchEvent.shiftKey (en-US) 読取専用

論理値で、タッチイベントが発行されたときにシフトキーが押されていたかどうかを示します。

TouchEvent.targetTouches (en-US) 読取専用

現在タッチ面に接触してしており、かつイベントのターゲット要素と同じ要素で開始された、すべての Touch オブジェクトの TouchList です。

TouchEvent.touches (en-US) 読取専用

対象や、変更されたステータスに関係なく、表面との現在の接点をすべて表す Touch オブジェクトの TouchList です。

TouchEvent.rotation Non-standard 読取専用

イベント開始時からの角度の変化(度)。正の値は時計回りの回転を示し、負の値は反時計回りの回転を示します。初期値は 0.0 です。

TouchEvent.scale Non-standard 読取専用

イベント開始時からの 2 つの指間の距離の変化です。イベント開始時の初期指間距離からの倍率を、浮動小数点数で表します。1.0 未満の値は、内側へのピンチ(ズームアウト)を示します。1.0 以上の値は、外側へのピンチ解除(ズームイン)を示します。初期値は 1.0 です。

サンプルコードはタッチイベントの専用のページにあります。

仕様書

Specification
Touch Events
# event-touchcancel
Touch Events
# dom-globaleventhandlers-ontouchcancel

ブラウザーの互換性

BCD tables only load in the browser

参照