Appearance
MosoweUpload组件
整合了常用的一些文件校验,可以上传图片、文档、音视频,图片及音视频点击有预览模式,文档类点击则下载。
常用校验文件后缀格式:
图片:['jpg', 'jpeg', 'png', 'gif', 'webp']
音频:['mp3', 'm4a', 'ogg', 'wav', 'ape', 'aiff', 'wma', 'vqf', 'flac', 'midi', 'voc', 'aac']
视频:['avi', 'ogg', 'mp4', 'mov', 'mkv', 'wmv', 'rmvb', 'imax', 'swf', 'mpeg', 'flv', 'webm']
内置校验规则含:文件大小、图片宽高、文件类型 三个板块
TIP
action
、v-model
属性必传。
基础用法
文件大小限制
设置fileSize
属性,可以控制上传文件的大小,支持number(默认单位M)和带单位的string类型,可以带的单位有b
/kb
/mb
。
图片宽高限制
设置width
及height
属性,可以控制上传文件的宽高。
其他类型
设置accept
属性,指定文件后缀,可以控制上传文件类型,change时会校验文件类型。
属性
属性 | 说明 | 类型 | 默认 |
---|---|---|---|
fileSize | 文件大小限制,支持number类型及string带单位 b,kb,mb | string / number | - |
sizeError | 文件大小限制异常提示语 | string | - |
width | 文件宽度限制 | number | - |
height | 文件高度限制 | number | - |
whError | 文件宽高异常提示 | string | - |
acceptError | 文件格式异常提示 | string | - |
listType | 上传按钮样式 | 'text' / 'picture' / 'picture-card' / 'drag' | 'text' |
notice | 上传提示语 | string | - |
text | 上传区文案 | string | |
verifySuccess | 校验成功后处理 | function | (files:UploadFiles)=>void |
otherVerify | 内置校验完成后需要做的一些其他校验,return promise, resolve通过 reject失败 | function | (files:UploadFiles)=>void |
apiKey | 上传接口返回参数指定存放文件路径的键,基于uploadFile.response 开始计算 | string | 'data' |
realmName | 上传后文件路径需要加前缀的,如果项目接口上传后只返回不带域名的后半段路径,这里需要写上前半段域名地址 | string | - |
emptyText | 只读时,图片列表为空时文案 | string | - |
justShow | 只读 | boolean | false |
autoUpload | 自动上传 | boolean | false |
el-upload组件属性 |
emits
名称 | 说明 | 参数 |
---|---|---|
upload-over | 文件上传完毕触发 |
expose
名称 | 说明 | 类型 |
---|---|---|
fileList | 文件类型 | any[] |
elUploadRef | el-upload组件ref | |
clearFiles | 清空已上传文件 | ()=>void |
submit | 提交 | ()=>void |
abort | 取消上传请求 | (file: UploadFile) => void |
handleStart | 手动选择文件 | (rawFile: UploadRawFile) => void |
handleRemove | 手动移除文件 | (file: UploadFile | UploadRawFile) => void |