Touch: Touch() コンストラクター

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Touch() コンストラクターは、新しい Touch オブジェクトを作成します。

構文

js
new Touch(options)

引数

touchInit

以下のフィールドを持つオブジェクトです。

identifier

long 値で、タッチ点の識別番号です。

target

EventTarget オブジェクトで、タッチ点が最初に表面に置かれたときに開始したアイテムです。

clientX 省略可

既定値は 0、型は double で、スクロールオフセットを除いた、ユーザー画面のクライアントウィンドウ上のタッチの水平位置です。

clientY 省略可

既定値は 0、型は double で、スクロールオフセットを除いた、ユーザー画面のクライアントウィンドウ上のタッチの垂直位置です。

screenX 省略可

既定値は 0、型は double で、ユーザーの画面上のタッチの水平位置です。

screenY 省略可

既定値は 0、型は double で、ユーザーの画面上のタッチの垂直位置です。

pageX 省略可

既定値は 0、型は double で、スクロールオフセットを含む、ユーザー画面のクライアントウィンドウ上のタッチの水平位置です。

pageY 省略可

既定値は 0、型は double で、スクロールオフセットを含む、ユーザー画面のクライアントウィンドウ上でのタッチの垂直位置です。

radiusX 省略可

既定値は 0、型は float で、 rotationAngle で示される軸に沿ったタッチ領域(指やスタイラスなど)を最も近く囲む楕円の半径を、screenX と同じ倍率の CSS ピクセル単位で指定します。値が不明な場合は 0 です。値は負であってはいけません。

radiusY 省略可

既定値は 0 で、タイプは float です。rotationAngle で示される軸に垂直な軸に沿って、タッチエリア(指やスタイラスなど)を最も近く囲む楕円の半径を、screenY と同じ倍率の CSS ピクセル単位で指定します。値が不明な場合は 0 です。値は負であってはいけません。

rotationAngle 省略可

既定値は 0 、型は float で、 radiusX と radiusY で記述する楕円を、その中心を軸に時計回りに回転させた角度(度単位)です。値は 0 以上、90 以下でなければなりません。radiusX と radiusY で記述される楕円が円の場合、 rotationAngle は影響しません。ユーザーエージェントはこの用途の値として 0 を使用してもよいですし、許容範囲内の他の値を使用してもかまいません。(例えば、ユーザーエージェントは突然の変化を避けるために、前回のタッチイベントの rotationAngle 値を使用することができます。)

force 省略可

既定値は 0、型は float で、加えられる圧力の相対値です。範囲は 0 から 1 で、 0 は圧力なし、 1 はそのタッチ機器が感知できる最高レベルの圧力です。値が不明の場合は 0 です。力が既知である環境では、力属性によって表される絶対圧と、圧力のレベルの感度が異なる場合があります。

仕様書

Specification
Touch Events
# dom-touch-constructor

ブラウザーの互換性

BCD tables only load in the browser

関連情報

  • TouchEvent: これを構築するオブジェクトのインターフェイス