TouchList: item() メソッド

item() メソッドは、この TouchList の中の指定された位置にある Touch オブジェクトを返します。

構文

js
item(index)

引数

index

取得する Touch オブジェクトの添字を指定します。添字は、0 から TouchList の長さより 1 つ小さい数までの数です。

返値

touchPoint

要求された Touch オブジェクトを TouchList から取得したものです。 添字がリストの長さ以上の場合は null を返します。

例

このコード例では、TouchList インターフェイスの item メソッドと length プロパティの使い方を示しています。

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

target.addEventListener(
  "touchstart",
  (ev) => {
    // この touchstart イベントが対象要素で始まった場合、touch を
    // targetTouches リストの最初の項目に設定します。そうでない
    // 場合は、touch リストの最初の項目に touch を設定します。
    const touch =
      ev.targetTouches.length >= 1
        ? ev.targetTouches.item(0)
        : ev.touches.item(0);
  },
  false,
);

仕様書

Specification
Touch Events
# dom-touchlist-item

ブラウザーの互換性

BCD tables only load in the browser