webkitdirectory 是浏览器原生支持文件夹上传的唯一可靠方式,仅 Chrome、Edge(Chromium)、新版 Safari 支持,Firefox 及旧版 IE/Edge 不支持;需配合 directory、multiple 属性使用,选中后 e.target.files 为扁平化 FileList,每个 File 的 webkitRelativePath 保留相对路径,用于还原目录结构及预览图片。

用 webkitdirectory 属性选中整个文件夹
浏览器原生支持文件夹上传的唯一可靠方式,是给 加上 webkitdirectory 属性。它不是标准属性,但 Chrome、Edge(基于 Chromium)、新版 Safari 都已支持;Firefox 仍不支持,IE/旧版 Edge 完全不可用。
必须显式声明 directory(可选)和 webkitdirectory(兼容性兜底),否则只触发单文件选择:
<input type="file" id="folderInput" webkitdirectory directory multiple>
注意三点:
-
multiple必须加,否则即使选中文件夹,e.target.files也只含一个File对象(代表该文件夹) - 选中的不是“文件夹对象”,而是该文件夹下**所有子文件**组成的
FileList,包括嵌套子目录里的文件 -
e.target.files中每个File的webkitRelativePath属性会保留其相对于所选文件夹的路径(如"photos/vacation/beach.jpg"),这是还原目录结构的唯一依据
遍历 FileList 并过滤出图片文件
用户选中文件夹后,change 事件拿到的 files 是扁平化的列表,没有层级关系。你要自己按 webkitRelativePath 分组、提取图片:
const input = document.getElementById('folderInput');
input.addEventListener('change', (e) => {
const files = Array.from(e.target.files);
const images = files.filter(file =>
file.type.startsWith('image/') &&
file.webkitRelativePath &&
/\.(jpe?g|png|gif|webp)$/i.test(file.webkitRelativePath)
);
renderPreviews(images);
});
关键点:
- 不要只靠
file.type判断——某些图片可能被识别为""或"application/octet-stream",必须结合文件扩展名正则校验 - 忽略无
webkitRelativePath的项(比如用户误选了根目录下的非图片文件) - 如果需要展示层级结构(如带文件夹图标+缩略图网格),得用
webkitRelativePath.split('/')提取父级路径,再做分组渲染
用 URL.createObjectURL() 预览每张图片
对每个符合条件的 File,调用 URL.createObjectURL(file) 生成临时 URL,直接赋给 即可。比 FileReader.readAsDataURL() 更快、不阻塞主线程、支持流式加载。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
但必须手动清理内存:
function renderPreviews(files) {
const container = document.getElementById('previewContainer');
container.innerHTML = '';
files.forEach(file => {
const url = URL.createObjectURL(file);
const img = document.createElement('img');
img.src = url;
img.alt = file.name;
img.style.maxWidth = '200px';
container.appendChild(img);
// 记录 cleanup 引用,避免后续无法 revoke
img.dataset.objectUrl = url;
});
}
// 页面卸载或切换时清理(例如用户换了个文件夹)
window.addEventListener('beforeunload', () => {
document.querySelectorAll('img[data-object-url]').forEach(img => {
URL.revokeObjectURL(img.dataset.objectUrl);
});
});
容易踩的坑:
- 不调
URL.revokeObjectURL()→ 内存持续增长,尤其预览上百张图时页面明显卡顿 - 把
createObjectURL返回的 URL 存到 localStorage 或发给后端 → 无效,该 URL 只在当前文档生命周期内有效 - 在
change事件里重复渲染却没清空旧img元素 → 内存泄漏 + 多余 URL 残留
后端接收时如何还原文件夹结构
前端只能提供每个 File 的 webkitRelativePath,后端需依赖这个字段重建目录。例如发送时在 FormData 中额外附带路径信息:
const formData = new FormData();
files.forEach(file => {
formData.append('files', file);
formData.append('paths', file.webkitRelativePath); // 同名数组,顺序一一对应
});
fetch('/upload-folder', { method: 'POST', body: formData });
后端(如 Node.js + Express + Multer)需同步解析 paths 字段,并用它构造保存路径:
// 伪代码:multer 接收后,paths 是字符串数组
const paths = req.body.paths; // ['a/b/c.png', 'd/e.jpg']
req.files.forEach((file, i) => {
const safePath = path.join('uploads', paths[i]); // 保证路径安全,防 ../ 注入
fs.mkdirSync(path.dirname(safePath), { recursive: true });
fs.copyFileSync(file.path, safePath);
});
重点提醒:
-
webkitRelativePath是浏览器生成的,不能被前端伪造,但后端必须做路径净化(拒绝含../或绝对路径的值) - 别指望
FormData自动携带路径——它只传二进制内容,路径必须显式append - 若服务端框架不支持多值同名字段(如
paths[]),改用 JSON 字符串:formData.append('pathsJson', JSON.stringify(paths))
实际最麻烦的从来不是“怎么选文件夹”,而是**Chrome 以外的浏览器根本没这功能**。如果你的产品必须支持 Firefox 或旧企业环境,就得退回到“多选文件 + 手动模拟目录树”或引入桌面端桥接方案。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










