Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Touch

Touch インターフェイスは、タッチ感応面へのひとつの接触点を表します。接触点は一般的に指やスタイラスと、タッチスクリーンやトラックパッドのようなデバイスが触れた位置です。

Touch.radiusXTouch.radiusYTouch.rotationAngle で、ユーザとスクリーンが接触したタッチ領域 (touch area) を表します。これは指を使うような、精度が低いポインティングデバイスを扱う場合に役立ちます。これらの値は、接触した領域全体 (ユーザの指先など) に可能な限り合う楕円を表すように設定されます。

注記: プロパティの値の多くは、ハードウェア依存です。例えば、表面を押さえる力を検出する手段を持たないデバイスでは、force の値が常に 0 になるでしょう。これは radiusXradiusY にもあてはまります。ハードウェアがひとつの点しか通知できない場合は、これらの値が 1 になるでしょう。

コンストラクタ

Touch()
Touch オブジェクトを作成します。

プロパティ

親インターフェイスが存在しないため、他のプロパティを継承および実装しません。

基本プロパティ

Touch.identifier 読取専用
Touch オブジェクトの一意な識別子を返します。あるタッチ個所 (指などによる) は表面を移動している間、同じ識別子を持ち続けます。これにより、同一のタッチを終始追跡することが確実になります。
Touch.screenX 読取専用
スクリーンの左端に対する、タッチ個所の X 座標を返します。
Touch.screenY 読取専用
スクリーンの上端に対する、タッチ個所の Y 座標を返します。
Touch.clientX 読取専用
スクロールによるオフセットを含まず、ブラウザのビューポートの左端に対する、タッチ個所の X 座標を返します。
Touch.clientY 読取専用
スクロールによるオフセットを含まず、ブラウザのビューポートの上端に対する、タッチ個所の Y 座標を返します。
Touch.pageX 読取専用
ドキュメントの左端に対する、タッチ個所の X 座標を返します。水平スクロールによるオフセットがある場合は、それを含むことが clientX と異なります。
Touch.pageY 読取専用
ドキュメントの上端に対する、タッチ個所の Y 座標を返します。垂直スクロールによるオフセットがある場合は、それを含むことが clientY と異なります。
Touch.target 読取専用
タッチ個所がタッチ面で最初に触れた位置にある Element を返します。タッチ個所が要素の対話エリアの外に移動したり、ドキュメント上に存在しなくなっても同様です。

タッチ領域

これは実験段階の機能です。
この機能は複数のブラウザで開発中の状態にあります。各ブラウザで用いるために、適切なベンダー接頭辞が必要な場合があります。互換性テーブルをチェックしてください。また、実験段階の機能の構文と挙動は、仕様変更に伴い各ブラウザの将来のバージョンで変更になる可能性があることに注意してください。

Touch.radiusX 読取専用
スクリーンに触れた領域にもっとも接近して囲むような、楕円の X 方向の半径を返します。この値は、screenX と同じ尺度のピクセル数で表します。
Touch.radiusY 読取専用
スクリーンに触れた領域にもっとも接近して囲むような、楕円の Y 方向の半径を返します。この値は、screenY と同じ尺度のピクセル数で表します。
Touch.rotationAngle 読取専用
ユーザがタッチ面に触れた領域をもっとも正確に覆うために、radiusX および radiusY で表す楕円を時計回りに回転すべき角度 (単位は度 (degree)) を返します。
Touch.force読取専用
ユーザがタッチ面に与えた圧力を、0.0 (最小圧力) から 1.0 (最大圧力) の間の float で返します。

メソッド

このインターフェイスにはメソッドがありません。また親インターフェイスが存在しないため、他のメソッドを継承および実装しません。

仕様

仕様書 策定状況 コメント
Touch Events – Level 2
Touch の定義
勧告改訂案 radiusXradiusYrotationAngleforce プロパティ、Touch() コンストラクタを追加。
Touch Events
Touch の定義
勧告 最初期の定義

ブラウザ実装状況

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
基本サポート 22.0 18.0 (18.0) 未サポート 未サポート 未サポート
radiusX, radiusY, rotationAngle, force ? (有) ? ? ?
Touch() コンストラクタ ? 未サポート ? ? ?
機能 Android Android Webview Chrome for Android Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) (有) 6.0 (6.0) (有) 11 (有) (有)
radiusX, radiusY, rotationAngle, force ? ? ? 6.0 (6.0) (有) ? ? ?
Touch() コンストラクタ ? ? ? 未サポート 未サポート ? ? ?

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: yyss
 最終更新者: yyss,