更新记录

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 平台不支持

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。