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 |
