跳到主要内容

Upload 上传 ​

WebH5

文件上传。点击卡片选择文件,支持多选、数量上限、自定义上传请求与图片缩略图列表;本库不做真实网络请求,由 httpRequest 接管。

何时使用 ​

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

何时不使用 ​

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

Props ​

名称类型默认值说明
modelValueUploadFile[]"[]"文件列表(v-model),项结构 { name, url?, status: ready|uploading|success|error, size? }
acceptstring"-"原生 accept,类型/格式校验交给浏览器
multiplebooleanfalse允许多选
maxCountnumber"-"最大文件数;达到上限隐藏上传卡片,超出部分触发 exceed
disabledbooleanfalse禁用(不可选择/删除)
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 同步)
remove(file: UploadFile, index: number)点击删除时触发
exceedFile[]选择文件超出 maxCount 时触发,参数为超出部分的原始文件

示例 ​

头像上传 ​

示例加载中…

多附件与数量上限 ​

示例加载中…

列表状态展示 ​

示例加载中…

限制文件类型 ​

示例加载中…

禁用态 ​

示例加载中…

拖拽上传 ​

示例加载中…

照片墙 ​

示例加载中…

事件监听与超出提示 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Upload 文档(含手机预览)。