跳到主要内容

Upload 上传 ​

uni-appH5微信小程序App

基于 uni.chooseImage 的跨端图片选择上传组件,支持多选和删除。

何时使用 ​

表单中需要选择并管理本地文件:头像、附件、图片墙。

何时不使用 ​

只展示图片用 Image;纯选择本地文件无列表管理需求时用原生 input[type=file]。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Upload 上传 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValueUploadFile[][]文件列表(v-model),项结构 { name, url?, status: ready|uploading|success|error, size? }
maxCountnumber9最大文件数;达到上限隐藏上传卡片,超出部分触发 exceed
disabledbooleanfalse禁用(不可选择/删除)
multiplebooleantrue允许多选
triggerTextstring"选择图片"上传触发按钮文案
acceptstring"-"原生 accept,类型/格式校验交给浏览器
tipstring"''"列表下方辅助说明文字
httpRequest(file: File, callbacks: { onProgress, onSuccess, onError }) => void"-"自定义上传请求;不传则选中文件直接标记 success 进入列表
dragbooleanfalse拖拽上传:上传区变为大块拖拽区(虚线框 + 图标文案),支持拖入文件;listType 为 text 时生效
listType'text' | 'picture-card'"'text'"列表类型;picture-card 为照片墙模式:96×96 缩略图卡片,hover 浮出预览/删除操作,预览调起 ImagePreview

Events ​

名称载荷说明
update:modelValueUploadFile[]文件列表变化时触发
changeUploadFile[]文件列表变化时触发(与 update:modelValue 同步)
removeUploadFile, number点击删除时触发
exceedUploadFile[]选择文件超出 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" />