src/upload-to-ali.vue
| Prop name | Type | Default | Required | Description |
|---|---|---|---|---|
v-model | string|array | Required | true | 图片地址, 支持v-model |
accept | string | image/* | 接受上传的文件类型, 多个值逗号分隔, 默认只接受图片 其他文件类型可以参考MIME 类型列表 | |
action | string | process.env.UPLOAD_ACTION | 上传地址 | |
beforeUpload | func | upload前的钩子函数，传入选择的文件，FileList类型。 要求返回一个promise，resolved则继续upload，rejected则停止上传。 调用时机在size和accept检验之前。 | ||
bucket | string | process.env.OSS_BUCKET | 存储空间的名字 | |
compressOptions | object | {
maxWidth: 750
} | ||
customDomain | string | process.env.OSS_CUSTOM_DOMAIN | 自定义域名, 该字段有值时, 返回的文件url拼接规则为: customDomain + / + dir + filename 域名无协议时, url默认以 // 开头 域名不需要/结尾 | |
dir | string | process.env.OSS_DIR || ' | 目录名, 一定要/结尾 | |
disabled | boolean | false | 是否禁用。若为true，则不能上传 | |
max | number | 9 | 允许上传的最大数量 | |
multiple | boolean | false | 是否多选 | |
onClick | func | 点击事件, 返回参数为当前点击的url | ||
onOversize | func | 所选文件超出size限制时的处理函数； 接收超出大小的文件作为参数 | ||
preview | boolean | true | 是否开启预览功能，需要全局注册 img-preview 组件 | |
region | string | process.env.OSS_REGION | 根据 存储空间 所在的存储区域, 相应的上传域名 | |
request | func | 自定义上传, 使用此函数则会覆盖默认的上传行为 返回 Promise, 接收 resolve 参数为 url | ||
size | number | 1024 | 上传文件大小限制, 单位为KB, 默认值为1024, 参考GitHub上传头像设置 | |
timeout | number | 0 | 暂不支持此props。超时时间, 单位毫秒, 大于0才生效 | |
tip | string | '' | 自定义上传提示内容 | |
uploadOptions | object | {
partSize: 100 * oneKB
} |
| Method name | Parameters | Description |
|---|---|---|
selectFiles() | 手动触发选择文件事件 |
| Event name | Type | Description |
|---|---|---|
input | undefined | |
delete | undefined | 删除图片事件 Argumentsurl: string — 被删除图片的url；index: number — 被删除图片的下标 |
loading | undefined | 上传过程中 Argumentsname: string — 当前上传的图片名称 |
fail | unknown | 上传失败 |
loaded | undefined | 上传完成后触发的事件。 Argumentsurls: string[]|string — multiple模式返回此次成功上传的文件url数组； 单张模式返回上传的url |
| Slot | Description |
|---|---|
default | 自定义上传区域，会覆盖 slot=spinner、slot=placeholder |
spinner | 自定义loading内容，默认类似 element-ui 的 v-loading |
placeholder | 自定义placeholder内容 |