HTMLInputElement: webkitEntries 屬性

HTMLInputElement 介面的只讀 webkitEntries 屬性包含一個檔案系統條目（作為基於 FileSystemEntry 的物件）陣列，代表使用者使用型別為 file 的 <input> 元素選擇的檔案和/或目錄。但前提是該選擇是透過拖放完成的：在對話方塊中選擇檔案將使該屬性為空。

僅當 webkitdirectory 屬性為 true 時，該陣列才能包含目錄。這意味著 <input> 元素已配置為允許使用者選擇目錄。

注意： 該屬性在規範中稱為 webkitEntries，因為它最初是 Google Chrome 特有的 API。它很可能會在將來重新命名。

值

一個基於 FileSystemEntry 的物件陣列，每個物件代表在 <input> 元素中選擇的一個檔案。更具體地說，檔案由 FileSystemFileEntry 物件表示，如果允許，目錄由 FileSystemDirectoryEntry 物件表示。

示例

本示例說明如何建立檔案選擇 <input> 元素並處理選定的檔案。

HTML

html

<input id="files" type="file" multiple />

JavaScript

document.getElementById("files").addEventListener("change", (event) => {
  event.target.webkitEntries.forEach((entry) => {
    /* do stuff with the entry */
  });
});

每次發生 change 事件時，此程式碼都會遍歷選定的檔案，獲取它們基於 FileSystemEntry 的物件並對它們進行操作。

規範

規範
File and Directory Entries API # dom-htmlinputelement-webkitentries

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後由 MDN 貢獻者於 2025 年 2 月 20 日修改。

在 GitHub 上檢視此頁面 • 報告此內容的問題