---
title: Document.createTouchList()
slug: Web/API/Document/createTouchList
tags:
  - API
  - DOM
  - Deprecated
  - Document
  - Method
  - Mobile
  - createTouchList
  - touch
  - タッチパネル
  - メソッド
translation_of: Web/API/Document/createTouchList
---
<div>{{APIRef("DOM")}}{{Deprecated_Header}}</div>

<div class="blockIndicator note">
<p><strong>注:</strong> {{Gecko("25.0")}} 以前では、このメソッドは {{DOMxRef("DocumentTouch")}} ミックスインで定義されていました。</p>
</div>

<p><strong><code>Document.createTouchList()</code></strong> メソッドは、<span class="seosummary">新しい {{DOMxRef("TouchList")}} オブジェクトを生成して返します。</span></p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox notranslate">var <var>list</var> = DocumentTouch.createTouchList([<var>touch1 [, touch2 [, ...]]]</var>);
</pre>

<h3 id="Parameters" name="Parameters">引数</h3>

<dl>
 <dt><code><var>touches</var></code></dt>
 <dd>0個以上の {{DOMxRef("Touch")}} オブジェクトです。 <strong>注:</strong> Firefox は {{DOMxRef("Touch")}} オブジェクトの<a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Array">配列</a>も受け付けます。</dd>
</dl>

<h3 id="Return_value" name="Return_value">返値</h3>

<dl>
 <dt><code><var>list</var></code></dt>
 <dd>{{DOMxRef("TouchList")}} オブジェクトで、 <code>touches</code> 引数で指定された {{DOMxRef("Touch")}} オブジェクトを含みます。</dd>
</dl>

<h2 id="Example" name="Example">例</h2>

<p>この例は、 {{DOMxRef("Document.createTouchList()")}} メソッドを使用して {{DOMxRef("TouchList")}} オブジェクトを生成する様子を紹介しています。</p>

<p>以下のコードスニペットでは、いくつかの {{DOMxRef("Touch")}} オブジェクトがタッチ点と共に <code>target</code> 要素に生成され、 {{DOMxRef("TouchList")}} オブジェクトを作成するために使用されます。</p>

<pre class="brush: js notranslate">var target = document.getElementById("target");

// Create some touch points
var touch1 = document.createTouch(window, target, 1, 15, 20, 35, 40);
var touch2 = document.createTouch(window, target, 2, 25, 30, 45, 50);

// Create an empty TouchList objects
var list0 = document.createTouchList();

// Create a TouchList with only one Touch object
var list1 = document.createTouchList(touch1);

// Create a list with two Touch objects
var list2 = document.createTouchList(touch1, touch2);
</pre>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("Touch Events", "#widl-Document-createTouchList-TouchList-Touch-touches", "Document.createTouchList()")}}</td>
   <td>{{Spec2("Touch Events")}}</td>
   <td>初回定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("api.Document.createTouchList")}}</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/Web/API/Touch_events">タッチイベント</a></li>
 <li>{{DOMxRef("Touch")}}</li>
 <li>{{DOMxRef("TouchEvent")}}</li>
 <li>{{DOMxRef("TouchList")}}</li>
 <li>{{DOMxRef("Document.createTouch()")}}</li>
</ul>