必须为每个文件配独立lay-filter,否则进度条会互相覆盖;progress只管发送进度,done才代表上传成功,预览需在choose中用FileReader处理。

必须给每个文件配独立 lay-filter,否则进度条会互相覆盖——这是最常被忽略的底层机制问题。
为什么所有文件共用同一个 lay-filter 会导致进度错乱
element.progress() 不是靠文件对象或索引识别进度条,而是靠 DOM 上的 lay-filter 属性精确匹配节点。多个文件如果都写 lay-filter="demo",后一个文件调用 element.progress("demo", "60%") 时,会直接覆盖前一个文件正在更新的进度条,最终只看到最后一个文件的跳变。
- HTML 中要为每个文件动态生成唯一
lay-filter,比如progress-0、progress-1 - 在
choose回调里遍历obj.files,用Array.from(obj.files)转成数组,再逐个插入带不同lay-filter的<div class="layui-progress"> <li>别忘了在 <code>done或error回调里手动设一次element.progress("progress-" + index, "100%"),否则可能卡在 99% - 切勿在
progress里判断n === 100就隐藏 loading、启用按钮或清空输入框 - 正确状态流转是:
progress管“发了多少”,done才是“服务器认了”,error是“服务器拒了” - 大文件场景下,
progress到 100% 后常需等待数秒才进done,建议加中间态提示如“正在保存…” - 预览逻辑必须放在
choose回调内,且要用Array.from(obj.files)遍历,不能等done - 每个
File对象可用来过滤非图片(比如跳过.pdf),但前端exts和size校验不可靠,后端必须重做 - 别在
choose里直接调obj.upload(),否则预览还没开始,上传就已发出 - 设
auto: false,在choose里缓存Array.from(obj.files) - 构造
FormData时,对每个File调用formData.append('files[]', file)(注意中括号) - 不要手动设置
Content-Type,浏览器会自动加上带boundary的multipart/form-data - 额外参数(如
token、dir)也统一用formData.append()加入
progress 回调里的 n === 100 并不等于上传成功
这个值只代表浏览器已把整个请求体发完(即 XMLHttpRequest.upload.onprogress 触发了 loaded === total),但服务端可能还在写磁盘、校验、生成缩略图,甚至网络 ACK 还没回来。此时响应还没收到,done 根本不会触发。
预览和进度不能混在同一个回调里做
Layui upload 模块本身不处理文件读取,choose 回调拿到的是 FileList,里面只有 name、size、type 等元信息,没有内容。想预览图片,必须用 FileReader 异步读取,这和上传进度完全无关。
一次性多文件上传要绕开 obj.upload()
Layui 默认行为是「多选 → 每个文件单独发一次请求」,不是你想要的「一个请求传多个文件」。如果后端接口要求接收 files[] 字段,就必须手动构造 FormData 并用 fetch 或 $.ajax 发送。
真正难的不是写几行 element.progress(),而是把「发出去」「收回来」「出错了」三个状态和 UI 严格对齐——尤其当用户同时拖入 20 个文件,每个进度条都得独立更新、各自完成、分别报错,这时候 DOM 插入时机、闭包变量生命周期、以及服务端 Nginx 的 client_max_body_size 限制,全都会暴露出来。


















