文件选择上传组件,可以选择图片、视频等任意文件并上传到当前绑定的服务空间。根据 file-mediatype 自动匹配 uni.chooseImage / uni.chooseVideo / uni.chooseMedia / uni.chooseFile,App 平台默认打开系统相册。宫格和列表均基于 uni-drag-cell 支持拖拽排序
本 Component 是 uni ext component,需下载插件:uni-file-picker
组件名:uni-file-picker 代码块:
uFilePicker
文件选择上传组件,可以选择图片、视频等任意文件并上传到云存储。
组件内部负责:
file-mediatype 自动匹配底层选择 API:image 使用 uni.chooseImage、video 使用 uni.chooseVideo、all 使用 uni.chooseFile、mix 使用 uni.chooseMedia。album-mode 默认 system),避免相册权限问题。file-extname 后缀过滤、删除、图片预览。auto-upload 为 true 时自动将文件上传到云存储,并抛出 progress / success / fail 事件。mode="grid")与列表(mode="list")均基于 uni-drag-cell 支持长按拖拽排序,排序结果通过 update:model-value 回传。使用方需要负责:
v-model 传入与接收文件数据;return-type 决定数据是数组还是单个对象。provider、dir 配置上传目标。auto-upload 为 false 时,自行调用组件暴露的 upload() 方法触发上传。external-class 自定义添加按钮与各区域样式。图片宫格,自动上传:
<template>
<uni-file-picker v-model="files" title="图片" :limit="9" @success="onSuccess" />
</template>
<script setup lang="ts">
import { ref } from 'vue'
const files = ref<any[]>([])
function onSuccess(result : UTSJSONObject) {
console.log('上传成功', result)
}
</script>
仅选择、不自动上传,手动触发:
<template>
<uni-file-picker ref="picker" v-model="files" :auto-upload="false" mode="list" />
<button @click="upload">开始上传</button>
</template>
<script setup lang="ts">
import { ref } from 'vue'
const files = ref<any[]>([])
const picker = ref<any>(null)
function upload() {
picker.value?.upload()
}
</script>
任意文件与后缀过滤:
<uni-file-picker v-model="files" file-mediatype="all" :file-extname="['pdf', 'docx', 'zip']" />
自定义区域样式:
<uni-file-picker
v-model="files"
title="自定义样式"
image-class="my-image-cell"
list-class="my-list"
title-class="my-title"
count-class="my-count"
item-class="my-item"
placeholder-class="my-add"
del-icon-class="my-del"
progress-class="my-progress"
error-class="my-error"
/>
uni-drag-cell(见 package.json 的 dependencies),拷贝组件时请同时拷贝该依赖。× 按钮);宽度大于等于 700px 时显示 × 按钮删除。App/手机默认走拖拽删除,Web 宽屏走 ×。delete 事件,参数与点击 × 删除一致。image-class 作用于宫格内的每个方形单元格(宽度由 column=3 控制,默认占满单元格),可用它调整内边距、圆角、边框等,不建议再改宽度;list-class 作用于列表区域容器。mix(uni.chooseMedia)仅 App 平台支持,Web 平台不支持。all(uni.chooseFile)在 App 平台不支持 extension、sourceType 等部分参数,以官方 API 文档为准。uni.chooseMedia 返回的 duration、size 精度统一为小数点后三位。content:// 地址,App 端如需长期使用,请上传到云存储或保存到应用沙盒。| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| modelValue | any[] | UTSJSONObject | null | [] | 组件数据,支持 v-model,格式由 return-type 决定 |
| value | any[] | UTSJSONObject | null | [] | 不使用 v-model 时传入的组件数据,格式由 return-type 决定 |
| returnType | string | "array" | 限制 value 格式,array 时返回数组,object 时只能单选且会覆盖 |
| autoUpload | boolean | true | 是否自动上传,false 时仅选择不触发上传 |
| limit | string | number | 9 | 最大选择个数 |
| mode | string | "grid" | 选择图片后的文件列表样式,grid 宫格显示,list 列表显示 |
| fileMediatype | string | "image" | 选择文件类型,image 只选图片,video 只选视频,all 选择任意文件,mix 同时选择图片和视频(仅 App) |
| fileExtname | string | string[] | "() : string[] => [] as string[]" | 选择文件后缀,支持数组或逗号分隔字符串 |
| title | string | "" | 组件标题,右侧显示上传计数 |
| provider | string | "" | 上传服务商 |
| dir | string | "" | 上传到云存储的目录 |
| sourceType | string[] | "() : string[] => ['album'] as string[]" | 选择来源,album 从相册选择,camera 使用相机 |
| sizeType | string[] | "() : string[] => ['original', 'compressed'] as string[]" | 是否压缩所选文件,original 原图 compressed 压缩图 |
| albumMode | string | "system" | 相册选择模式,custom 自定义选择器 system 系统相册 |
| camera | string | "back" | 摄像头,front 前置 back 后置 |
| maxDuration | number | 10 | 拍摄视频最长时长,单位秒 |
| mediaType | string[] | "() : string[] => ['image', 'video'] as string[]" | chooseMedia 的媒体类型,image 图片 video 视频 mix 混合 |
| compressed | boolean | false | 是否压缩所选视频 |
| pageOrientation | string | "" | 屏幕方向,仅 Android 生效,auto 自动 portrait 竖屏 landscape 横屏 |
| imageClass | string(string.ClassString) | "" | 图片宫格单元格的自定义样式类 |
| listClass | string(string.ClassString) | "" | 文件列表区域的自定义样式类 |
| titleClass | string(string.ClassString) | "" | 标题的自定义样式类 |
| countClass | string(string.ClassString) | "" | 右侧计数的自定义样式类 |
| itemClass | string(string.ClassString) | "" | 列表项的自定义样式类 |
| placeholderClass | string(string.ClassString) | "" | 添加或选择按钮区域的自定义样式类 |
| delIconClass | string(string.ClassString) | "" | 删除按钮的自定义样式类 |
| progressClass | string(string.ClassString) | "" | 上传进度条的自定义样式类 |
| errorClass | string(string.ClassString) | "" | 上传失败重试遮罩的自定义样式类 |
| @select | Function | 选择文件后触发 | |
| @progress | Function | 文件上传时触发 | |
| @success | Function | 上传成功触发 | |
| @fail | Function | 上传失败触发 | |
| @delete | Function | 文件从列表移除时触发 | |
| @update:modelValue | Event | v-model 绑定值变化时触发 |