layui upload怎么实现多文件上传并显示上传进度条

夜伟吖_3941

夜伟吖_3941

2026-11-20

627人浏览

原创

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

layui upload怎么实现多文件上传并显示上传进度条

必须给每个文件配独立 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 的
  • 别忘了在 done 或 error 回调里手动设一次 element.progress("progress-" + index, "100%"),否则可能卡在 99%
  • progress 回调里的 n === 100 并不等于上传成功

    这个值只代表浏览器已把整个请求体发完(即 XMLHttpRequest.upload.onprogress 触发了 loaded === total),但服务端可能还在写磁盘、校验、生成缩略图,甚至网络 ACK 还没回来。此时响应还没收到,done 根本不会触发。

    • 切勿在 progress 里判断 n === 100 就隐藏 loading、启用按钮或清空输入框
    • 正确状态流转是:progress 管“发了多少”,done 才是“服务器认了”,error 是“服务器拒了”
    • 大文件场景下,progress 到 100% 后常需等待数秒才进 done,建议加中间态提示如“正在保存…”

    预览和进度不能混在同一个回调里做

    Layui upload 模块本身不处理文件读取,choose 回调拿到的是 FileList,里面只有 name、size、type 等元信息,没有内容。想预览图片,必须用 FileReader 异步读取,这和上传进度完全无关。

    深蓝色网站后台管理系统layui框架模板-AdminPro
    深蓝色网站后台管理系统layui框架模板-AdminPro

    一款深蓝色网站后台管理系统layui框架模板

    下载
    • 预览逻辑必须放在 choose 回调内,且要用 Array.from(obj.files) 遍历,不能等 done
    • 每个 File 对象可用来过滤非图片(比如跳过 .pdf),但前端 exts 和 size 校验不可靠,后端必须重做
    • 别在 choose 里直接调 obj.upload(),否则预览还没开始,上传就已发出

    一次性多文件上传要绕开 obj.upload()

    Layui 默认行为是「多选 → 每个文件单独发一次请求」,不是你想要的「一个请求传多个文件」。如果后端接口要求接收 files[] 字段,就必须手动构造 FormData 并用 fetch 或 $.ajax 发送。

    • 设 auto: false,在 choose 里缓存 Array.from(obj.files)
    • 构造 FormData 时,对每个 File 调用 formData.append('files[]', file)(注意中括号)
    • 不要手动设置 Content-Type,浏览器会自动加上带 boundary 的 multipart/form-data
    • 额外参数(如 token、dir)也统一用 formData.append() 加入

    真正难的不是写几行 element.progress(),而是把「发出去」「收回来」「出错了」三个状态和 UI 严格对齐——尤其当用户同时拖入 20 个文件,每个进度条都得独立更新、各自完成、分别报错,这时候 DOM 插入时机、闭包变量生命周期、以及服务端 Nginx 的 client_max_body_size 限制,全都会暴露出来。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3123

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6843

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7650

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7638

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1083

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

5031

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

9088

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

914

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

774

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 13.3万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.6万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习