i-image-upload vue图片上传组件

vue picture component. Resize and preview your uploaded image

使用指南

1import iImageUpload from 'i-image-upload'
2import 'i-image-upload/dist/i-image-upload.css'
3
4Vue.use(iImageUpload)

i-image-upload 代码演示

普通表单上传

可以在组件内部添加子节点传入自定义的上传按钮类型和文字提示

1<form 
2  action="http://localhost:1400/avatar" 
3  method="post" 
4  enctype="multipart/form-data"
5>
6  <i-image-upload name="file">
7    <i class="demo-icon">+</i>
8  </i-image-upload>
9  <button>上传</button>
10</form>

默认上传

使用 before-upload 限制用户上传的图片格式和大小, 只有返回 true, 才会继续上传图片，否则停止

1<template>
2  <form>
3    <i-image-upload 
4      name="file" 
5      action="http://localhost:1400/avatar" 
6      :before-upload="beforeUpload"
7      :on-preview="onPreview"
8      :on-success="onSuccess"
9      :on-error="onError"
10    >
11      <img v-if="imagePreview" :src="imagePreview" class="demo-avatar">
12      <i class="demo-icon" v-else>+</i>
13    </i-image-upload>
14  </form>
15</template>
16
17<script>
18export default {
19  data () {
20    return {
21      imagePreview: ''
22    }
23  },
24  methods: {
25    beforeUpload (file) {
26      const isJPG = file.type === 'image/jpeg'
27      const isLt2M = file.size / 1024 / 1024 < 2
28
29      if (!isJPG) {
30        console.error('上传头像图片只能是 JPG 格式!')
31      }
32      if (!isLt2M) {
33        console.error('上传头像图片大小不能超过 2MB!')
34      }
35      return isJPG && isLt2M
36    },
37    onPreview (file) {
38      this.imagePreview = file
39    },
40    onSuccess (res, dataurl) {
41      console.log(res)
42    },
43    onError (res, dataurl) {
44      console.log(res)
45      this.imagePreview = ''
46    }
47  }
48}
49</script>
50
51<style scoped>
52.demo-icon {
53  border: 1px dashed lightblue;
54  width: 100px;
55  height: 100px;
56  text-align: center;
57  line-height: 100px;
58  display: block;
59  font-style: normal;
60  color: lightblue;
61  font-size: 26px;
62}
63.demo-avatar {
64  border: 1px dashed lightblue;
65  width: 100px;
66  height: 100px;
67}
68</style>

自定义ajax上传

使用 custom-handle-upload 覆盖默认的上传行为，可以自定义上传的实现

1<template>
2  <form>
3    <i-image-upload 
4      name="file" 
5      action="http://localhost:1400/avatar" 
6      resultType="blob"
7      :before-upload="beforeUpload"
8      :customHandleUpload="onhandleUpload"
9      :on-success="onSuccess"
10      :on-error="onError"
11    >
12      <img v-if="imagePreview" :src="imagePreview" class="demo-avatar">
13      <i class="demo-icon" v-else>+</i>
14    </i-image-upload>
15  </form>
16</template>
17
18<script>
19export default {
20  data () {
21    return {
22      imagePreview: ''
23    }
24  },
25  methods: {
26    beforeUpload (file) {
27      const isJPG = file.type === 'image/jpeg'
28      const isLt2M = file.size / 1024 / 1024 < 2
29
30      if (!isJPG) {
31        console.error('上传头像图片只能是 JPG 格式!')
32      }
33      if (!isLt2M) {
34        console.error('上传头像图片大小不能超过 2MB!')
35      }
36      return isJPG && isLt2M
37    },
38    onhandleUpload (formatFile) {
39      this.imagePreview = formatFile
40      let filedata = new FormData()
41      filedata.append('file', data)
42
43      return fetch('http://localhost:1400/avatar', {
44        method: 'post',
45        mode: 'no-cors',
46        body: filedata
47      })
48    },
49    onSuccess (res, dataurl) {
50      console.log(res)
51      this.imagePreview = res.data.imageUrl
52    },
53    onError (res, dataurl) {
54      console.log(res)
55      this.imagePreview = ''
56    }
57  }
58}
59</script>

API

参数	说明	类型	默认值
name	上传的图片字段名	String	file
disabled	是否禁用	Boolean	false
maxWidth	不压缩上传的最大宽度 autoScale为true的时候才有用	Number	1024
maxHeight	不压缩上传的最大高度 autoScale为true的时候才有用	Number	1024
autoScale	上传图片超出maxWidth或者maxHeight时自动压缩	Boolean	true
quality	上传图像的质量，0 - 1.00之间的浮点数	Boolean	true
scaleRatio	上传图像的缩放比例，接受0 - 1之间的浮点数， 譬如0.5指缩放为原来的一半	Number	-
autoRotate	解析图像中的EXIF信息，并在上传之前正确旋转图像	Boolean	true
capture	设置可选的捕获属性	String	-
resultType	返回上传图片或者预览图片所需要的格式	String ['base64', 'blob']	base64
action	默认上传行为的上传地址	String	-
custom-handle-upload	覆盖默认的上传行为，可以自定义上传的实现	function(file, extra)	—
before-upload	上传图片之前的钩子，参数为上传的图片，只有返回 true, 才会继续上传图片，否则停止	function(file)	—
on-preview	预览上传图片的钩子	function(file)	—
on-progress	图片默认ajax上传时的钩子	function(event, dataurl)	—
on-success	图片上传成功时的钩子	function(response, dataurl)	—
on-error	图片上传失败时的钩子	function(response, dataurl)	—