Upload 上传
uni-appH5微信小程序App
基于 uni.chooseImage 的跨端图片选择上传组件,支持多选和删除。
何时使用
表单中需要选择并管理本地文件:头像、附件、图片墙。
何时不使用
只展示图片用 Image;纯选择本地文件无列表管理需求时用原生 input[type=file]。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | UploadFile[] | [] | 文件列表(v-model),项结构 { name, url?, status: ready|uploading|success|error, size? } |
maxCount | number | 9 | 最大文件数;达到上限隐藏上传卡片,超出部分触发 exceed |
disabled | boolean | false | 禁用(不可选择/删除) |
multiple | boolean | true | 允许多选 |
triggerText | string | "选择图片" | 上传触发按钮文案 |
accept | string | "-" | 原生 accept,类型/格式校验交给浏览器 |
tip | string | "''" | 列表下方辅助说明文字 |
httpRequest | (file: File, callbacks: { onProgress, onSuccess, onError }) => void | "-" | 自定义上传请求;不传则选中文件直接标记 success 进入列表 |
drag | boolean | false | 拖拽上传:上传区变为大块拖拽区(虚线框 + 图标文案),支持拖入文件;listType 为 text 时生效 |
listType | 'text' | 'picture-card' | "'text'" | 列表类型;picture-card 为照片墙模式:96×96 缩略图卡片,hover 浮出预览/删除操作,预览调起 ImagePreview |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | UploadFile[] | 文件列表变化时触发 |
change | UploadFile[] | 文件列表变化时触发(与 update:modelValue 同步) |
remove | UploadFile, number | 点击删除时触发 |
exceed | UploadFile[] | 选择文件超出 maxCount 时触发,参数为超出部分的原始文件 |
示例
基础用法
vue
<Upload v-model="uploadFiles" />限制数量
vue
<Upload v-model="uploadFiles" :max-count="3" trigger-text="上传凭证" />禁用
vue
<Upload v-model="uploadFiles" disabled />照片墙与类型限制
vue
<Upload v-model="uploadFiles" list-type="picture-card" accept="image/*" tip="仅支持图片,最多 3 张" :max-count="3" />