讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Vue 3 逻辑复用怎么处理文件上传与进度条的通用封装

轻墨姑娘_3112

轻墨姑娘_3112

发布时间:2026-11-19 10:28:26

|

814人浏览过

|

来源于php中文网

原创

Vue 3 文件上传通用封装核心是 useUpload 组合式函数,统一管理上传逻辑、进度计算(Math.round((e.loaded/e.total)*100))、分片断点续传、错误重试与取消清理,返回响应式状态和纯净 API,不绑定 UI。

vue 3 逻辑复用怎么处理文件上传与进度条的通用封装

Vue 3 中处理文件上传与进度条的通用封装,核心是把上传逻辑、状态管理、进度计算、错误恢复等能力从组件中抽离,用组合式 API(Composable)统一组织。这样既能复用,又便于测试、升级和跨项目迁移。

用 useUpload 封装基础上传能力

把文件选择、FormData 构建、请求发起、响应解析等收进一个 useUpload 函数里,返回 ref 管理的 fileList、progress、status 和函数如 upload()、cancel():

  • 内部用 ref 存当前进度值,配合 watch 或事件回调实时更新
  • 支持单文件 / 多文件模式,通过参数控制是否自动清空上次列表
  • 默认携带 token、自定义 header,可透传额外字段(如业务 ID、分类)
  • 失败时提供重试入口,不强绑定 UI,由调用方决定是否弹窗或展示错误提示

进度条要精准,就得接管原生 upload 过程

别依赖 el-upload 的 on-progress —— 它只在 xhr 层面触发,粒度粗、不准、无法取消。改用 Axios 或 fetch + AbortController 手动控制:

Vue工具箱(免费版)
Vue工具箱(免费版)

规避 Vue 3 常见陷阱:响应式、ref 与 reactive、computed 时机与组合式 API 优选实践。

下载
  • 创建 FormData 后,用 XMLHttpRequest 或 fetch 发起请求,并监听 upload.onprogress
  • 进度计算公式: Math.round((e.loaded / e.total) * 100),注意 e.total 可能为 0(流式上传或服务端未设 Content-Length)
  • 把进度值暴露为响应式 ref,让进度条组件直接绑定,无需额外事件总线
  • 上传取消后,主动清理 xhr 实例或 abort fetch,避免内存泄漏

大文件场景必须分片 + 断点续传

单次上传 GB 级文件极易超时或中断,真正健壮的封装要内置分片能力:

立即学习“前端免费学习笔记(深入)”;

  • 用 File.prototype.slice() 按固定大小(如 2MB)切块,每块带序号、hash、偏移量
  • 上传前先算全文件 MD5(用 Web Worker 防止主线程卡顿),发给服务端判断是否秒传
  • 若非秒传,先查已上传分片列表,只上传缺失部分;合并成功后再触发最终回调
  • 并发控制(如最多同时传 3 片)、失败重试(带退避策略)、断网自动暂停,都应在 hook 内部闭环

与 UI 组件解耦,适配不同技术栈

封装的目标不是做一个“万能上传组件”,而是提供可插拔的逻辑层:

  • 不强制依赖 Element Plus 或 Vxe-UI,useUpload 返回的是纯逻辑和状态,UI 自由渲染
  • 可轻松对接 el-upload(覆盖其 uploadMethod)、vxe-upload(传入 upload-method)、甚至原生 input
  • 类型定义写清楚:UploadOptions、UploadResult、UploadStatus,TS 支持开箱即用
  • 对外暴露的 API 干净:只有 upload(file)、cancel()、reset(),无副作用

热门AI工具

更多
豆包大模型

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

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

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

DeepSeek

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

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

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

3103

2023.08.11

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

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

6803

2023.10.09

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

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

7610

2024.03.19

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

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

7578

2024.03.22

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

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

1083

2024.05.22

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

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

5011

2023.10.23

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

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

9028

2024.03.06

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

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

914

2025.12.30

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.6万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习

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

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