Skip to content

Commit

Permalink
Improve TouchList
Browse files Browse the repository at this point in the history
  • Loading branch information
mikecat committed Oct 29, 2024
1 parent 5e8f12c commit 27c2bbe
Showing 1 changed file with 4 additions and 3 deletions.
7 changes: 4 additions & 3 deletions files/ja/web/api/touchlist/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,16 @@
title: TouchList
slug: Web/API/TouchList
l10n:
sourceCommit: d414c502f3cc1c08d2fb043e98cda4a65621ff08
sourceCommit: cfa628aedb53a83b315943ef19fa6c73298fb7d5
---

{{APIRef("Touch Events")}}

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

> [!NOTE]
> このインターフェイスは[変更不可能なリストを作成しようとするもの](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)で、すでに使用しているコードを壊さないために対応しているだけです。現代の API では、代わりに ECMAScript の配列型をラップした型を使用しているので、ECMAScript の配列のように扱うことができ、同時にその使用方法に追加の意味づけをすることができます(例えば、アイテムを読み取り専用にする)。
このインターフェイスは[変更不可能なリストを作成しようとしたもの](https://stackoverflow.com/questions/74630989/why-use-domstringlist-rather-than-an-array/74641156#74641156)で、すでに使用しているコードを壊さないために対応しているだけです。現代の API では、JavaScript の[配列](/ja/docs/Web/JavaScript/Reference/Global_Objects/Array)をベースにした型でリストを表現しています。このことにより、配列のメソッドの多くを利用可能にし、同時にその使用方法に追加の意味づけをすることができます (例えば、アイテムを読み取り専用にする)。

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

## インスタンスプロパティ

Expand Down

0 comments on commit 27c2bbe

Please sign in to comment.