Upload 上传
文件上传组件,支持图片预览、多选、大小限制和上传前钩子
文件上传组件,支持图片预览、多选、大小限制和上传前钩子
演示
9:41
代码示例
引入
推荐使用 easycom 模式,配置后无需手动 import 即可直接使用 <re-upload />。
API
Upload Props
| 名称 | 类型 | 默认值 | 描述 | 必传 |
|---|---|---|---|---|
| files | Array<UploadFile> | 文件列表 | N | |
| max | number | 0 | 最大上传数量,0 表示不限制 | N |
| sizeLimit | UTSJSONObject | {} | 文件大小限制(字节),如 { size: 5242880, unit: 'B' } | N |
| accept | string | "image" | 可接受的文件类型,如 "image" / "image/,video/" | N |
| multiple | boolean | false | 是否支持多选 | N |
| disabled | boolean | false | 是否禁用 | N |
| beforeUpload | (file: UploadFile) => boolean | null | 上传前钩子函数,返回 false 或 Promise<false> 可阻止上传 | N |
| customStyle | string | "" | 自定义样式 | N |
Upload Events
| 名称 | 参数 | 描述 |
|---|---|---|
| success | file: UploadFile | 上传成功时触发 |
| fail | file: UploadFile, error: string | 上传失败时触发 |
| remove | index: number, file: UploadFile | 移除文件时触发 |
| progress | file: UploadFile, progress: number | 上传进度变化时触发 |
| change | files: Array<UploadFile> | 文件列表变化时触发 |
| select | files: Array<UploadFile> | 选择文件时触发 |
Upload Slots
| 名称 | 描述 |
|---|---|
| - | - |
