blob: 584201eb0c8011223b742c0e35b84da39308963c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
---
title: DataTransferItemList
slug: Web/API/DataTransferItemList
tags:
- API
- DataTransferItemList
- HTML DOM
- HTML Drag and Drop API
- Interface
- NeedsTranslation
- Reference
- TopicStub
- drag and drop
translation_of: Web/API/DataTransferItemList
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>
<p>The <code><strong>DataTransferItemList</strong></code> object is a list of {{domxref("DataTransferItem")}} objects representing items being dragged. During a <em>drag operation</em>, each {{domxref("DragEvent")}} has a {{domxref("DragEvent.dataTransfer","dataTransfer")}} property and that property is a <code>DataTransferItemList</code>.</p>
<p>This interface has no constructor.</p>
<h2 id="Properties">Properties</h2>
<dl>
<dt>{{domxref("DataTransferItemList.length")}} {{readonlyInline}}</dt>
<dd>An <code>unsigned long</code> that is the number of drag items in the list.</dd>
</dl>
<h2 id="Methods">Methods</h2>
<dl>
<dt>{{domxref("DataTransferItemList.add()")}}</dt>
<dd>Adds an item (either a {{domxref("File")}} object or a {{domxref("DOMString","string")}}) to the drag item list and returns a {{domxref("DataTransferItem")}} object for the new item.</dd>
<dt>{{domxref("DataTransferItemList.remove()")}}</dt>
<dd>Removes the drag item from the list at the given index.</dd>
<dt>{{domxref("DataTransferItemList.clear()")}}</dt>
<dd>Removes all of the drag items from the list.</dd>
<dt>{{domxref("DataTransferItemList.DataTransferItem()")}}</dt>
<dd>Getter that returns a {{domxref("DataTransferItem")}} at the given index.</dd>
</dl>
<h2 id="Example">Example</h2>
<p>Each of this interface's methods and properties has a reference page, and each reference page has an example of its usage.</p>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName('HTML WHATWG', 'interaction.html#datatransferitemlist','DataTransferItemList')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName('HTML5.1', 'editing.html#datatransferitemlist','DataTransferItemList')}}</td>
<td>{{Spec2('HTML5.1')}}</td>
<td>Not included in W3C HTML5 {{Spec2('HTML5 W3C')}}</td>
</tr>
<tr>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p> </p>
<p>{{Compat("api.DataTransferItemList")}}</p>
<p> </p>
|
