Appearance
image-upload
基于 Element Plus 的图片上传组件,支持预览、删除、进度显示等功能。
基础用法
属性
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
url | 图片地址,支持 v-model | string | '' |
action | 上传地址 | string | - |
headers | 请求头 | object | - |
data | 上传时附带的额外参数 | object | - |
name | 上传的文件字段名 | string | 'file' |
size | 图片大小限制(MB) | number | 20 |
width | 图片显示宽度(px) | number | 160 |
height | 图片显示高度(px) | number | 90 |
accept | 接受的文件类型 | string | 'image/jpeg,image/jpg,image/png,image/gif' |
placeholder | 上传区域提示文字 | string | '点击上传图片' |
notip | 是否隐藏提示文字 | boolean | false |
tipText | 自定义提示文字 | string | - |
beforeUpload | 上传前的钩子函数 | (file: File) => boolean | Promise<boolean> | - |
事件
事件名 | 说明 | 回调参数 |
---|---|---|
update:url | 图片地址更新时触发 | (url: string) |
onSuccess | 上传成功时触发 | (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) |
功能特点
- 支持拖拽上传
- 自动校验文件类型和大小
- 实时显示上传进度
- 支持图片预览和删除
- 可自定义提示文字和样式
- 支持上传前的文件校验
注意事项
- 上传前会自动校验文件类型和大小限制
- 文件大小超过限制或类型不符会有错误提示
- 可以通过 beforeUpload 钩子函数进行自定义校验
- 组件内部会自动处理文件预览 URL 的创建和释放