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

仕様書

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

ブラウザーの互換性

BCD tables only load in the browser

関連情報