更新记录

0.1.3（2025-09-16）

• chore: 更新文档

0.1.2（2025-06-07）

• chore: 更新文档

0.1.1（2025-06-02）

• feat: 兼容鸿蒙next

平台兼容性

uni-app(4.61)

uni-app x(4.61)

lime-choose-file 文件选择组件

一个基于UTS实现的文件选择插件，参考小程序chooseFile API实现，用法保持一致。支持安卓、iOS、鸿蒙和H5平台。提供了选择图片、视频和其他文件类型的功能。组件提供了简单易用的API，使开发者能够方便地在应用中集成文件选择功能。

文档链接

📚 组件详细文档请访问以下站点：

• 文件选择组件文档 - 站点1
• 文件选择组件文档 - 站点2
• 文件选择组件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-choose-file
2. 导入后在页面引入相关方法
3. 需要自定义基座才能使用
4. 试用符合需求后才购买，插件无法退款

代码演示

UNIAPPX 使用方式

import { chooseFile, type ChooseFileOption } from '@/uni_modules/lime-choose-file'

const images = ref<string[]>([])
const onClick = () => {
    chooseFile({
        filename: 'xxxx', // 可选 用于给文件重命名（安卓、iOS）
        type: 'image',
        success(res){
            images.value = res.tempFiles.map((item):string => item.path)
            console.log('选择结果:', res.tempFiles)
        },
        fail(err){
            console.log('选择失败:', err)
        }
    } as ChooseFileOption)
}

UNIAPP 使用方式

import { chooseFile } from '@/uni_modules/lime-choose-file'

const images = ref<string[]>([])
const onClick = () => {
    chooseFile({
        filename: 'xxxx', // 可选 用于给文件重命名（安卓、iOS）
        type: 'image',
        success(res){
            images.value = res.tempFiles.map((item):string => item.path)
            console.log('选择结果:', res.tempFiles)
        },
        fail(err){
            console.log('选择失败:', err)
        }
    })
}

API文档

chooseFile 方法

ChooseFileOption 选项

ChooseFileSuccessCallbackResult 返回参数

ChooseFile 对象结构

文件类型说明

功能特点

• 支持多种文件类型的选择，包括图片、视频和其他文件
• 支持文件重命名功能
• 兼容安卓、iOS、鸿蒙和H5平台
• 提供简单易用的API接口
• 支持指定最大选择数量
• 支持文件扩展名过滤（H5平台）

常见问题

• iOS路径是中文时无法上传到服务器，这时候需要设置filename给文件重命名
• APP端需要自定义基座才能使用
• 文件选择后会返回临时文件路径，需要及时使用或保存
• H5端可以通过extension参数过滤文件类型

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助