1. 開発者向けのウェブ技術
  2. Web API
  3. TouchList

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

View in English Always switch to English

TouchList

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more support for this feature? Tell us why.

TouchList インターフェイスは、タッチ面上の接触点のリストを表します。例えば、ユーザーがタッチ面(画面やトラックパッドなど)を 3 本指で操作している場合、対応する TouchList オブジェクトは 1 本の指あたり 1 つの Touch オブジェクトを持ち、全部で 3 項目になります。

このインターフェイスは変更不可能なリストを作成しようとしたもので、すでに使用しているコードを壊さないために対応しているだけです。現代の API では、JavaScript の配列をベースにした型でリストを表現しています。このことにより、配列のメソッドの多くを利用可能にし、同時にその使用方法に追加の意味づけをすることができます (例えば、アイテムを読み取り専用にする)。

この歴史的な理由は、開発者が TouchList を避けるべきということではありません。開発者は TouchList のオブジェクトを自分で作成するのではなく、TouchEvent.targetTouches などの API から取得するでしょう。そして、これらの API は非推奨になっていません。ただし、本物の配列との意味論的な違いには注意するべきです。

インスタンスプロパティ

TouchList.length 読取専用

TouchList 中の Touch オブジェクトの個数です。

インスタンスメソッド

TouchList.item()

リスト内の指定した位置の Touch オブジェクトを返します。

タッチイベントのメイン記事にある例をご覧ください。

仕様書

仕様書
Touch Events
# touchlist-interface

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

AltStyle によって変換されたページ (->オリジナル) /