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 上查看此页面 • 报告此内容的问题