讲师中心 微信公众号
AI工具推荐 视频效率加速

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

秋辰君_5286

秋辰君_5286

发布时间:2026-05-27 09:48:27

|

507人浏览过

|

来源于php中文网

原创

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(); // 全部通过才放行
}
  • 注意 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 < chunks) {
loadNext();
} else {
obj.md5 = spark.end(); // ⚠️ 唯一合法获取位置
obj.upload();
}
};</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();
}
  • 分片大小建议 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 <= 5 * 1024 * 1024 && /\.pdf$/i.test(file.name);
  });
<p>if (validFiles.length === 0) {
layer.msg('所选文件均不符合要求(≤5MB,PDF 格式)');
obj.reset();
return;
}</p><p>if (validFiles.length !== obj.files.length) {
layer.msg('已自动过滤 ' + (obj.files.length - validFiles.length) + ' 个不合规文件');
}</p><p>// 手动触发上传,传入过滤后文件(需 polyfill FileList)
obj.upload({
files: validFiles
});
}
  • 原生 FileList 不可构造,需用 new DataTransfer().files 或借助临时 input 模拟(Layui v2.8+ 支持直接传数组)
  • 若用旧版 Layui,更稳妥的方式是遍历 validFiles,对每个文件单独调用 obj.upload({ files: [file] })
  • 提示语要明确告知过滤数量,避免用户困惑“为什么少了几个”
  • 服务端接口需适配多文件接收逻辑,不能假定每次只收一个

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

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

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

2523

2023.08.11

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

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

5463

2023.10.09

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

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

6490

2024.03.19

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

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

6118

2024.03.22

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

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

863

2024.05.22

ajax教程
ajax教程

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

2880

2023.06.14

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

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

360

2023.08.31

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

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

2693

2023.11.15

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

40

2026.10.16

热门下载

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

精品课程

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

共87课时 | 12.9万人学习

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

共89课时 | 11.1万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn