Upload 上传
WebH5
文件上传。点击卡片选择文件,支持多选、数量上限、自定义上传请求与图片缩略图列表;本库不做真实网络请求,由 httpRequest 接管。
何时使用
表单中需要选择并管理本地文件:头像、附件、图片墙。
何时不使用
只展示图片用 Image;纯选择本地文件无列表管理需求时用原生 input[type=file]。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | UploadFile[] | "[]" | 文件列表(v-model),项结构 { name, url?, status: ready|uploading|success|error, size? } |
accept | string | "-" | 原生 accept,类型/格式校验交给浏览器 |
multiple | boolean | false | 允许多选 |
maxCount | number | "-" | 最大文件数;达到上限隐藏上传卡片,超出部分触发 exceed |
disabled | boolean | false | 禁用(不可选择/删除) |
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 | (file: UploadFile, index: number) | 点击删除时触发 |
exceed | File[] | 选择文件超出 maxCount 时触发,参数为超出部分的原始文件 |
示例
头像上传
示例加载中…
多附件与数量上限
示例加载中…
列表状态展示
示例加载中…
限制文件类型
示例加载中…
禁用态
示例加载中…
拖拽上传
示例加载中…
照片墙
示例加载中…
事件监听与超出提示
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Upload 文档(含手机预览)。