2021/09/15 時点の英語版に同期

1 files changed, 72 insertions, 0 deletions

diff --git a/files/ja/web/api/htmlinputelement/webkitentries/index.md b/files/ja/web/api/htmlinputelement/webkitentries/index.md
new file mode 100644
index 0000000000..a14b173bf1
--- /dev/null
+++ b/files/ja/web/api/htmlinputelement/webkitentries/index.md
@@ -0,0 +1,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")}}