更新记录
1.0.0(2026-06-28)
新增
- 初始版本发布
- 支持 Android、iOS文件选择
- 支持多选文件(通过
count 参数控制最大选择数量,默认9)
- 支持单个文件大小限制(通过
maxSize 参数,单位字节,0表示不限制)
- 支持后缀名过滤(通过
extensions 参数,如 [".jpg", ".png", ".pdf"]、'image'、‘doc’)
平台兼容性
uni-app(5.07)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
Android插件版本 |
iOS |
iOS插件版本 |
鸿蒙 |
| - |
- |
- |
- |
- |
- |
5.0 |
1.0.0 |
14 |
1.0.0 |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| - |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
uni-app x(5.07)
| Chrome |
Safari |
Android |
Android插件版本 |
iOS |
iOS插件版本 |
鸿蒙 |
微信小程序 |
| - |
- |
5.0 |
1.0.0 |
14 |
1.0.0 |
- |
- |
cc-choose-file
跨平台文件选择 UTS API 插件,支持 Android、iOS。
功能特性
- ✅ 跨平台:Android / iOS
- ✅ 多选文件(
count 参数控制)
- ✅ 文件数量限制
- ✅ 单文件大小限制(
maxSize 参数,单位字节)
- ✅ 后缀名过滤(
extensions 参数)
使用方法
import { chooseFile } from "@/uni_modules/cc-choose-file";
chooseFile({
count: 3,
extensions: [".doc", ".docx", ".pdf"],
success(res) {
console.log(res.files);
}
});
参数
| 参数名 |
类型 |
必填 |
默认值 |
说明 |
| count |
number |
否 |
9 |
最大选择文件数量,不传表示不限制 |
| maxSize |
number |
否 |
0 |
单个文件大小限制,单位字节,0或者不传表示不限制 |
| extensions |
string[] |
否 |
[] |
允许的文件后缀名,如 [".jpg", ".png"],空数组表示不限制 |
| success |
Function |
否 |
- |
接口调用成功的回调函数 |
| fail |
Function |
否 |
- |
接口调用失败的回调函数 |
| complete |
Function |
否 |
- |
接口调用结束的回调函数 |
success 回调参数
| 属性 |
类型 |
说明 |
| errMsg |
string |
固定值 "chooseFile:ok" |
| files |
ChooseFileInfo[] |
选择的文件列表 |
ChooseFileInfo
| 属性 |
类型 |
说明 |
| name |
string |
文件名称 |
| path |
string |
文件路径(Android为content URI,iOS为file URL |
| size |
number |
文件大小,单位字节 |
| type |
string |
null |
文件MIME类型 |
错误码
| 错误码 |
说明 |
| 9010001 |
用户取消选择 |
| 9010002 |
选择的文件数量超限 |
| 9010003 |
文件大小超限 |
| 9010004 |
文件类型不支持(后缀名不匹配) |
| 9010005 |
获取文件信息失败 |
| 9010006 |
平台不支持 |