Element: touchstart イベント

touchstart イベントは、タッチ平面上に 1 つ以上のタッチ点が配置されたときに発生します。

構文

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

js
addEventListener("touchstart", (event) => {});

ontouchstart = (event) => {};

イベント型

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

Event UIEvent TouchEvent

イベントプロパティ

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

TouchEvent.altKey 読取専用

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

TouchEvent.changedTouches 読取専用

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

TouchEvent.ctrlKey 読取専用

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

TouchEvent.metaKey 読取専用

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

TouchEvent.shiftKey 読取専用

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

TouchEvent.targetTouches 読取専用

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

TouchEvent.touches 読取専用

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

TouchEvent.rotation Non-standard 読取専用

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

TouchEvent.scale Non-standard 読取専用

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

これらのイベントのコード例は、専用のページ「タッチイベント」にあります。

仕様書

Specification
Touch Events
# event-touchstart
Touch Events
# dom-globaleventhandlers-ontouchstart

ブラウザーの互換性

BCD tables only load in the browser

関連情報