HTMLInputElement: webkitEntries 属性

webkitEntriesHTMLInputElement 接口的只读属性,它包含一个文件系统条目数组(基于 FileSystemEntry 的对象),表示用户使用类型为 file<input> 元素选择的

仅当 webkitdirectory 属性为 true 时,该数组才能包含目录。这意味着 <input> 元素已配置为允许用户选择目录。

注意:此属性在规范中被称为 webkitEntries,因为它起源于 Google Chrome 专属的 API。它很可能在将来被重命名。

一个基于 FileSystemEntry 的对象数组,每个对象代表一个在 <input> 元素中选择的文件。更具体地说,文件由 FileSystemFileEntry 对象表示,并且,如果允许,目录由 FileSystemDirectoryEntry 对象表示。

示例

此示例演示如何创建文件选择 <input> 元素并处理所选文件。

HTML

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

JavaScript

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

每次发生 change 事件时,此代码都会遍历所选文件,获取其基于 FileSystemEntry 的对象并对其进行操作。

规范

规范
文件和目录条目 API
# dom-htmlinputelement-webkitentries

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅