このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Document: createTouch() メソッド

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

Document.createTouch() メソッドは、新しい Touch オブジェクトを生成して返します。

メモ: TouchEvent() コンストラクターを使用してください。

構文

js
createTouch(view, target, identifier, pageX, pageY, screenX, screenY)

引数

メモ: すべての引数が省略可能です。

view

タッチが発生した window です。

target

タッチの EventTarget です。

identifier

Touch.identifier の値です。

pageX

Touch.pageX の値です。

pageY

Touch.pageY の値です。

screenX

Touch.screenX の値です。

screenY

Touch.screenY の値です。

メモ: このメソッドの以前のバージョンでは、以下の追加の引数を含んでいましたが、これらの引数は下記の標準のいずれにも含まれていません。従って、これらの引数は非推奨であり、使用されないと考えてください。

clientX

Touch.clientX の値です。

clientY

Touch.clientY の値です。

radiusX

Touch.radiusX の値です。

radiusY

Touch.radiusY の値です。

rotationAngle

Touch.rotationAngle の値です。

force

Touch.force の値です。

返値

touch

入力引数で記述されたように構成された Touch オブジェクトです。

この例は Document.createTouch() メソッドを使用して Touch オブジェクトを生成する様子を示しています。

以下のコードスニペットでは、2 つの Touch オブジェクトが target 要素に生成されます。

js
const target = document.getElementById("target");

const touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
const touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

仕様書

この機能は、現在のどの仕様にも属しません。標準化の予定はなくなりました。

ブラウザーの互換性

関連情報