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

View in English Always switch to English

Document: createTouch() メソッド

非推奨;: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

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

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);

仕様書

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

ブラウザーの互換性

関連情報