使用elementUI的 el-upload 组件,封装一个上传图片的组件

Published on:
Tags: VUE

上传图片一个非常常用的功能,使用 elementUI 的 el-upload 组件,可以方便的实现上传图片文件等,用法参照例子 用户头像上传

如例子所示,每次使用该组件,都要写如下代码:

  • 引用组件 el-upload
  • 写回调函数 handleAvatarSuccess,beforeAvatarUpload
  • 写CSS样式代码

demo.vue

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
<el-upload
class="avatar-uploader"
action="https://jsonplaceholder.typicode.com/posts/"
:show-file-list="false"
:on-success="handleAvatarSuccess"
:before-upload="beforeAvatarUpload">
<img v-if="imageUrl" :src="imageUrl" class="avatar">
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
</el-upload>

<style>
.avatar-uploader .el-upload {
border: 1px dashed #d9d9d9;
border-radius: 6px;
cursor: pointer;
position: relative;
overflow: hidden;
}
.avatar-uploader .el-upload:hover {
border-color: #409EFF;
}
.avatar-uploader-icon {
font-size: 28px;
color: #8c939d;
width: 178px;
height: 178px;
line-height: 178px;
text-align: center;
}
.avatar {
width: 178px;
height: 178px;
display: block;
}
</style>

<script>
export default {
data() {
return {
imageUrl: ''
};
},
methods: {
handleAvatarSuccess(res, file) {
this.imageUrl = URL.createObjectURL(file.raw);
},
beforeAvatarUpload(file) {
const isJPG = file.type === 'image/jpeg';
const isLt2M = file.size / 1024 / 1024 < 2;

if (!isJPG) {
this.$message.error('上传头像图片只能是 JPG 格式!');
}
if (!isLt2M) {
this.$message.error('上传头像图片大小不能超过 2MB!');
}
return isJPG && isLt2M;
}
}
}
</script>

如果在多个地方都需要用到上传图片的功能,那么就要多次写同样的代码,显然没必要。

稍微封装一下 demo.vue 的代码,使它变成一个独立的组件,通过简单的调用,就可以实现上传图片的功能。

该组件接收一个图片地址参数,当有图片地址的时候,显示图片;
还有一个回调函数,当图片地址发生改变时,可以通知父组件。

upImg.vue

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<template>
<div>
<el-upload
v-loading="upLoading"
class="avatar-uploader"
:action="apiUrl+'/system/upload/upImg'"
:show-file-list="false"
name="file"
:data="setUpData()"
:on-success="handleAvatarSuccess"
:before-upload="beforeAvatarUpload"
>
<img v-if="imgUrl" :src="imgUrl" class="avatar"/>
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
<div class="el-upload__tip" slot="tip">只能上传jpg/png文件,且不超过2MB</div>
</el-upload>
</div>
</template>

<script>
import { getToken } from '@/utils/auth'

export default {
name: 'upImg',
props: ['imageUrl'],// 图片上传地址
data() {
return {
// 上传加载
upLoading: false,
imgUrl: undefined
}
},
watch: {
imageUrl: {
immediate: true,
handler(value) {
this.imgUrl = value
}
}
},
methods: {
handleAvatarSuccess(res, file) {
if (res.code === 0) {
this.imgUrl = URL.createObjectURL(file.raw)
this.$emit('getImgUrl', res.data.fileInfo.fileUrl)
} else {
this.msgError(res.msg)
}
this.upLoading = false
},
beforeAvatarUpload(file) {
const isJPG = (file.type === 'image/jpeg' || file.type === 'image/png')
const isLt2M = file.size / 1024 / 1024 < 2

if (!isJPG) {
this.$message.error('上传头像图片只能是 JPG 或 PNG 格式!')
return false
}
if (!isLt2M) {
this.$message.error('上传头像图片大小不能超过 2MB!')
return false
}
this.upLoading = true
return isJPG && isLt2M
},
setUpData() {
return { token: getToken() }
}
}
}
</script>

<style scoped>
.avatar-uploader .el-upload {
border: 1px dashed #d9d9d9;
border-radius: 6px;
cursor: pointer;
position: relative;
overflow: hidden;
}

.avatar-uploader .el-upload:hover {
border-color: #409eff;
}

.avatar-uploader-icon {
font-size: 28px;
color: #8c939d;
width: 99px;
height: 99px;
line-height: 99px;
text-align: center;
}

.avatar {
width: 99px;
height: 99px;
display: block;
}
</style>

upImg.vue 组件定义 imgUrl 变量作为图片的地址,
当父组件调用 upImg.vue 组件时,传入一个图片地址参数 imageUrl ,
子组件接收并监听该参数,当参数值发生变化时,赋值给 imgUrl 变量。

当成功上传图片后,imgUrl 取得图片地址, 并且触发父组件上的 getImgUrl 事件,抛出图片地址。

父组件只要监听 getImgUrl 事件,即可访问图片地址。

如下代码即是父组件的调用过程。

index.vue

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<template>
<up-img v-on:getImgUrl="getImgUrl" :imageUrl="imageUrl"/>
</template>

<script>
import upImg from '@/components/upImg/upImg'
export default {
components: { upImg },
methods: {
getImgUrl(url) {
console.log(url)
},
}
}
</script>

以上,通过对 el-upload 组件的封装,实现上传功能,简化了调用过程。