Skip to content

image-upload

基于 Element Plus 的图片上传组件,支持预览、删除、进度显示等功能。

基础用法

属性

属性说明类型默认值
url图片地址,支持 v-modelstring''
action上传地址string-
headers请求头object-
data上传时附带的额外参数object-
name上传的文件字段名string'file'
size图片大小限制(MB)number20
width图片显示宽度(px)number160
height图片显示高度(px)number90
accept接受的文件类型string'image/jpeg,image/jpg,image/png,image/gif'
placeholder上传区域提示文字string'点击上传图片'
notip是否隐藏提示文字booleanfalse
tipText自定义提示文字string-
beforeUpload上传前的钩子函数(file: File) => boolean | Promise<boolean>-

事件

事件名说明回调参数
update:url图片地址更新时触发(url: string)
onSuccess上传成功时触发(response: any, uploadFile: UploadFile, uploadFiles: UploadFiles)

功能特点

  1. 支持拖拽上传
  2. 自动校验文件类型和大小
  3. 实时显示上传进度
  4. 支持图片预览和删除
  5. 可自定义提示文字和样式
  6. 支持上传前的文件校验

注意事项

  1. 上传前会自动校验文件类型和大小限制
  2. 文件大小超过限制或类型不符会有错误提示
  3. 可以通过 beforeUpload 钩子函数进行自定义校验
  4. 组件内部会自动处理文件预览 URL 的创建和释放

Released under the MIT License.