Layui如何实现上传组件在选择文件后立即触发自定义的校验逻辑

秋辰君_5286

秋辰君_5286

2026-05-27

507人浏览

原创

choose回调是唯一能做即时校验的入口,文件选中后仅在此处可获取原始file对象进行大小、类型、md5等同步校验,错过则无法获取文件数据。

choose 回调是唯一能做即时校验的入口

文件一旦被用户选中,layui 的 upload 组件只在 choose 回调里暴露原始 file 对象——这是你读取 size、name、type 甚至计算 md5 的**最后且唯一合法时机**。错过这个回调,后续的 before 里 obj 已不带文件数据,done 或 error 更是请求结束之后,校验完全失效。

常见错误是把校验逻辑写在 before 里,以为还能拿到文件信息;实际运行时 obj.getChooseFiles() 在某些版本中返回空数组或报错,导致校验逻辑静默跳过。

  • choose 触发时机:用户点击“选择文件”→ 弹出系统对话框 → 用户确认后立即执行
  • 此时 obj.files 是标准 FileList,单文件用 obj.files[0],多文件需遍历
  • IE 下部分旧版可能用 file.fileSize 替代 file.size,需兼容判断
  • 校验失败必须手动调用 obj.reset(),否则 UI 显示“已选择”,但后续点击上传会无响应

大小和格式校验必须在 choose 里同步完成

文件大小超限、类型不符这类基础校验,必须在 choose 中同步判断并阻断,不能依赖服务端返回或异步提示。因为用户选完就期待立刻反馈,延迟到 before 甚至上传中再提示,体验断裂且浪费带宽。

示例中限制 5MB 且仅允许 PDF:

choose: function(obj) {
  var file = obj.files[0];
  if (!file) return;
<p>if (file.size > 5 <em> 1024 </em> 1024) {
layer.msg('文件不能大于 5MB');
obj.reset();
return;
}</p><p>if (file.type !== 'application/pdf' && !/.pdf$/i.test(file.name)) {
layer.msg('仅支持 PDF 格式');
obj.reset();
return;
}</p><p>obj.upload(); // 全部通过才放行
}</p>
  • 注意 file.type 不可靠(浏览器依赖 MIME 探测),务必结合 file.name 后缀双重校验
  • 正则匹配后缀要用 /\.pdf$/i,避免误判 my.pdf.bak 这类名字
  • 不要用 alert(),它阻塞主线程,且无法关闭;layer.msg() 是 Layui 官方推荐方案
  • 若配置了 auto: false,记得显式调用 obj.upload(),否则不会上传

MD5 校验必须分片读取,且只能在 choose 中启动

防重复上传依赖文件内容哈希,而计算 MD5 必须读取二进制内容——这只能在 choose 中用 FileReader 分片完成。一次性读全量会卡死浏览器,尤其对百 MB 级文件。

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

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

下载

关键点在于:SparkMD5.ArrayBuffer 的 end() 方法只能调用一次,且调用后内部状态清空。必须在全部分片加载完毕后立刻取值,然后挂载到 obj 上供后续使用:

choose: function(obj) {
  var file = obj.files[0];
  var spark = new SparkMD5.ArrayBuffer();
  var chunkSize = 2 * 1024 * 1024;
  var currentChunk = 0;
  var chunks = Math.ceil(file.size / chunkSize);
  var fileReader = new FileReader();
<p>fileReader.onload = function(e) {
spark.append(e.target.result);
currentChunk++;
if (currentChunk </p><p>function loadNext() {
var start = currentChunk * chunkSize;
var end = Math.min(start + chunkSize, file.size);
fileReader.readAsArrayBuffer(file.slice(start, end));
}</p><p>loadNext();
}</p>
  • 分片大小建议 2MB,太大易内存溢出,太小则 I/O 开销高
  • 不能在 before 中尝试重新计算 MD5——此时 file 已不可访问
  • 计算出的 obj.md5 可在 before 中读取并拼入请求参数,例如 obj.field.md5 = obj.md5
  • 如果用户连续快速选择多个文件,需注意 obj 实例是每次独立的,无需担心污染

多文件场景下校验失败不能简单 reset 全部

用户一次选 10 个文件,其中 2 个超限,你不能直接 obj.reset() 清空全部——这违背用户意图,也影响操作效率。正确做法是在 choose 中过滤合规文件,再逐个或批量上传。

需要改用 obj.upload() 的多文件模式,并传入过滤后的 FileList(注意:不是数组,需转为真实 FileList):

choose: function(obj) {
  var validFiles = Array.from(obj.files).filter(function(file) {
    return file.size if (validFiles.length === 0) {
layer.msg('所选文件均不符合要求(≤5MB,PDF 格式)');
obj.reset();
return;
}<p>if (validFiles.length !== obj.files.length) {
layer.msg('已自动过滤 ' + (obj.files.length - validFiles.length) + ' 个不合规文件');
}</p><p>// 手动触发上传,传入过滤后文件(需 polyfill FileList)
obj.upload({
files: validFiles
});
}</p>
  • 原生 FileList 不可构造,需用 new DataTransfer().files 或借助临时 input 模拟(Layui v2.8+ 支持直接传数组)
  • 若用旧版 Layui,更稳妥的方式是遍历 validFiles,对每个文件单独调用 obj.upload({ files: [file] })
  • 提示语要明确告知过滤数量,避免用户困惑“为什么少了几个”
  • 服务端接口需适配多文件接收逻辑,不能假定每次只收一个

复杂点在于:校验逻辑一旦嵌入 choose,就和用户交互强耦合,任何异步操作(比如查重、权限验证)都会打断选择流程。所以真正需要服务端参与的校验,得提前做,或改用按钮触发式上传而非自动选择即传。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2523

5

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

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

2023.10.09

5463

6

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

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

2024.03.19

6470

13

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

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

2024.03.22

6098

10

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

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

2024.05.22

863

5

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2880

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2693

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习