blob: a14b173bf1e2068f9493c500125c6a3518880a92 (
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
|
---
title: HTMLInputElement.webkitEntries
slug: Web/API/HTMLInputElement/webkitEntries
tags:
- API
- ファイルシステム API
- ファイルとディレクトリー項目 API
- Files
- HTML DOM
- HTMLInputElement
- 標準外
- プロパティ
- webkitEntries
browser-compat: api.HTMLInputElement.webkitEntries
---
{{APIRef("File System API")}}{{SeeCompatTable}}{{Non-standard_header}}
**`webkitEntries`** は {{domxref("HTMLInputElement")}} インターフェイスの読み取り専用プロパティで、ユーザーが `file` 型の {{HTMLElement("input")}} 要素を用いて選択したファイルやディレクトリーを表す、ファイルシステムのエントリー（ {{domxref("FileSystemEntry")}} に基づくオブジェクト）の配列を含みます。その選択がドラッグ＆ドロップで行われた場合にのみ、ダイアログ内でファイルを選択しても、プロパティは空になります。
{{domxref("HTMLInputElement.webkitdirectory", "webkitdirectory")}} プロパティが `true` である場合のみ、配列が入ることがあります。これは、 `<input>` 要素でユーザーがディレクトリーを選択することができることを意味します。
> **Note:** このプロパティは仕様書で `webkitEntries` と呼ばれていますが、これはもともと Google Chrome 独自の API であったためです。いつか改名される可能性があります。
## 構文
```js
var entries = HTMLInputElement.webkitEntries;
```
### 値
{{domxref("FileSystemEntry")}} に基づいたオブジェクト配列で、それぞれの要素が {{HTMLElement("input")}} 要素で選択されたファイルを表します。具体的には、ファイルは {{domxref("FileSystemFileEntry")}} オブジェクトで表現され、許可されていれば、ディレクトリーは {{domxref("FileSystemDirectoryEntry")}} オブジェクトで表されます。
## 例
この例では、ファイル選択 `<input>` 要素を作成し、選択されたファイルを処理する方法を示しています。
### HTML
```html
<input id="files" type="file" multiple>
```
### JavaScript
```js
document.getElementById("files").addEventListener("change", function(event) {
event.target.webkitEntries.forEach(function(entry) {
/* do stuff with the entry */
});
});
```
{{domxref("HTMLElement/chagne_event", "change")}} イベントが発生するたびに、このコードは選択されたファイルリストを走査して、 {{domxref("FileSystemEntry")}} ベースのオブジェクトを取得し操作をします。
## 仕様書
{{Specifications}}
この API は公式な W3C または WHATWG の仕様書にはありません。
## ブラウザーの互換性
{{Compat}}
## 関連情報
- [ファイルとディレクトリー項目 API](/ja/docs/Web/API/File_and_Directory_Entries_API)
- [ファイルシステム API 入門](/ja/docs/Web/API/File_and_Directory_Entries_API/Introduction)
- {{domxref("HTMLInputElement")}}
- {{domxref("FileSystemEntry")}}
- {{domxref("FileSystem")}}
|
