uni-app怎么实现多附件上传预览 uni-app文件列表管理方法【代码】

秋静吖_5128

秋静吖_5128

2026-04-12

366人浏览

原创

uni-app 多附件上传需分类型处理:chooseimage 选图片并直接预览,choosemessagefile 选非图片文件但 ios 路径仅临时有效;须立即转为统一结构并串行/并行上传,非图片文件仅能图标+名称展示,pdf用uni.opendocument预览,视频需单独choosevideo。

uni-app怎么实现多附件上传预览 uni-app文件列表管理方法【代码】

uni-app 里 chooseMessageFile 和 chooseImage 怎么选

多附件上传预览,核心是先拿到文件对象列表 —— 但 uni-app 没有统一的「多类型多文件选择」API,得按类型拆开处理。chooseImage 只能选图片,chooseMessageFile(iOS/Android 10+ 支持)才能选任意文件(含 PDF、Excel、视频等),且后者不支持直接预览非图片类型。

  • chooseImage 返回的是 tempFiles 数组,每个 item 有 path、size、name,可直接用 <image></image> 标签预览
  • chooseMessageFile 返回的 tempFiles 中,path 在 Android 上是真实路径(可读),iOS 上是沙盒临时路径(仅能通过 uni.getFileInfo 或上传接口读取,不能直接 src 渲染)
  • 想统一管理图片 + 其他文件,得分开调用,再合并数据结构;别指望一个 API 搞定所有类型

怎么把选中的文件存成可渲染/可上传的列表

用户选完后,不能直接把原始 tempFiles 存进 data —— 它们生命周期短、路径不稳定,尤其 iOS 的 chooseMessageFile 路径几秒后就失效。必须立刻转成可用形式。

  • 图片类:用 uni.compressImage(可选)或直接保留 tempFiles[i].path,赋值给 fileList 中的 url 字段,供 <image></image> 渲染
  • 非图片类:需立即调用 uni.getFileInfo({ filePath }) 获取 size 和校验,同时生成唯一 id 和人工 name(tempFiles[i].name 在某些安卓机型上为空)
  • 列表项建议结构:{ id: 'xxx', url: 'xxx', name: 'xxx', size: 12345, type: 'image/jpeg' || 'application/pdf', path: 'xxx' },其中 url 仅图片有值,其他用占位图标 + 文件名显示

上传时 uni.uploadFile 怎么传多个文件

uni-app 的 uni.uploadFile 不支持一次传多个文件,所谓「多附件上传」本质是串行或并行多次调用。并发太多容易被拦截或失败,得控制节奏。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • 别用 for 循环直接发 —— 缺少错误隔离,一个失败全崩;改用 Promise.allSettled 包裹每个 uni.uploadFile 调用
  • 每个请求的 filePath 必须是当时选中后保存的 path,不能用旧的或已清空的临时路径;iOS 上若用 chooseMessageFile 后没立刻上传,大概率报错 fail file not exist
  • 后端字段名要对齐:如果后端要求每个文件用 file[0]、file[1],前端就得每次传不同 name;若统一用 file,则后端需支持数组解析

预览 PDF / 视频这类非图片文件怎么办

uni-app 内置组件不支持直接渲染 PDF 或视频缩略图,也没法像 Web 那样用 <embed></embed> 或 <video></video> 标签加载本地路径(iOS 尤其严格)。

  • PDF:只能跳转内置 WebView 预览,用 uni.openDocument({ filePath: xxx }),注意它会新开页面,且 Android 需提前授权存储权限
  • 视频:无法预览缩略图,但可调用 uni.chooseVideo 单独选,它返回的 tempFilePath 才能用于 <video></video> 播放;混在 chooseMessageFile 里选的视频,iOS 上基本不可播
  • 通用方案:非图片文件统一显示为「? fileName」文字 + 文件图标,点击后根据类型分别处理(PDF 调 openDocument,视频提示「请单独上传」)

真正麻烦的不是代码怎么写,而是不同平台对「文件路径」的处置逻辑完全不一致 —— iOS 的临时路径、安卓的 scoped storage、微信小程序的独立沙盒,都得各自兜底。别省那两行兼容判断,否则上线后用户点不动附件,第一反应永远是「功能坏了」,而不是「系统限制」。

相关文章

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

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

下载

相关标签:

uni-app

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

相关专题

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

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

2023.08.11

2583

5

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

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

2023.10.09

5603

6

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

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

2024.03.19

6610

13

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

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

2024.03.22

6278

10

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

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

2024.05.22

883

5

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

2026.10.21

20

15

Playwright 页面操作指南
Playwright 页面操作指南

Playwright页面操作专题汇集元素定位、点击与输入、等待响应、多页面切换、Iframe、事件监听及文件处理的已审核文章,便于按操作场景查阅示例与常见问题。

2026.10.21

0

16

Playwright 入门教程
Playwright 入门教程

Playwright入门专题汇集测试框架安装、VS Code配置、录制脚本、编写首个用例、运行调试及查看报告的已审核文章,帮助初学者搭建端到端测试流程。

2026.10.21

0

16

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

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

2026.10.16

120

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习