TouchEvent: targetTouches プロパティ

targetTouches は読み取り専用プロパティで、タッチ面にまだ接触しているタッチ点のうち、 touchstart イベントが現在のターゲット要素 (element) と同じターゲット要素内で発生したものを表すすべての Touch オブジェクトを列挙する TouchList です。

タッチ面にまだ接触しているタッチ点のうち、 touchstart イベントが現在のターゲット要素 (element) と同じターゲット要素内で発生したものを表すすべての Touch オブジェクトを列挙する TouchList です。

この例では TouchEvent オブジェクトの TouchEvent.targetTouches プロパティを説明します。 TouchEvent.targetTouches プロパティは TouchList オブジェクトで、現在のイベントの対象となる要素で現在タッチ面に触れているタッチ点を含めるために使用します。そのため、 targetTouches リストは touches リストの厳密な部分集合です。

以下のコードでは、この関数は touches リストの長さと targetTouches リストの長さを比較し、同じであれば true を返し、そうでなければ false を返します。

js
function touches_in_target(ev) {
  // すべてのタッチが対象要素内にある場合は true を返す。
  // そうでない場合は false を返す。
  return ev.touches.length === ev.targetTouches.length;
}

仕様書

Specification
Touch Events
# dom-touchevent-targettouches

ブラウザーの互換性

BCD tables only load in the browser