轻量级Vue图片上传插件——Vue-core-image-Upload

介绍

vue-core-image-upload 是一款轻量级的 Vue.js 上传插件,它可以支持的图片的上传,裁剪,压缩。它同样也支持在移动端的图片处理,它定义了诸多上传周期,你可以自由的进行流程控制。




轻量级Vue图片上传插件——Vue-core-image-Upload



Github

https://github.com/Vanthink-UED/vue-core-image-upload

安装

npm install vue-core-image-upload --save

安装完成后,编辑源码

<template>
<div class="center">
<vue-core-image-upload
class="btn btn-primary"
:crop="false"
@imageuploaded="imageuploaded"
:data="data"
:max-file-size="5242880"
url="***" >
</vue-core-image-upload>
</div>
</template>

<script>
import VueCoreImageUpload from 'core/vue-core-image-upload.vue'

export default {
components: {
'vue-core-image-upload': VueCoreImageUpload,
},
data() {
return {
src: '***.png',
}
},
methods: {
imageuploaded(res) {
if (res.errcode == 0) {
this.src = res.data.src;
}
}
}
};
</script>

基本属性

Vue-core-image-upload 提供了很多可配置的选项,从而希望尽可能的满足开发者的需求。

<vue-core-image-upload
:class="['btn', 'btn-primary']"
:crop="false"
@imageuploaded="imageuploaded"
:data="data"
:max-file-size="5242880"
url="***" >
</vue-core-image-upload>


轻量级Vue图片上传插件——Vue-core-image-Upload

响应事件

我们在上传的不同阶段指定了不同的派发事件,你可以绑定每个事件的响应方法,实现对于流程的控制。

  • imageuploaded

当图片上传完,会调用该事件绑定的函数,并且用户可以获取到服务端返回的数据。

  • imagechanged

当input框改变选择图片时候触发,会返回input的获取的图片数据

  • imageuploading

当图片上传过程中触发,你可以自定义你需要处理的内容比如显示加载动画等。

  • errorhandle

当图片上传发生错误的时候触发,会返回错误状态信息


<vue-core-image-upload
:class="['btn', 'btn-primary']"
:crop="false"
@imagechanged="imagechanged"
@imageuploading="imageuploading"
@imageuploaded="imageuploaded"
:max-file-size="5242880"
url="***.php" >
</vue-core-image-upload>
methods: {
imagechanged() {
this.step += 1;
},

imageuploading() {
this.step += 1;
},

imageuploaded(res) {
this.step += 1;
this.src = res.data.src;
}
}

自定义组件样式

你可以设置组件的class 以及自己编写子组件的形式来控制组件的显示的样子。


轻量级Vue图片上传插件——Vue-core-image-Upload

<vue-core-image-upload
:crop="false"
@imageuploaded="imageuploaded"
:data="data"
:max-file-size="5242880"
url="***.php" >
<img width="150" src="***.png" />
</vue-core-image-upload>

裁剪图片

你可以通过设置 crop,来实现图片的裁剪。你可以指定图片裁剪的宽高,以及它的最大宽度和高度这些参数。

设置 cropRatio来限制裁剪图片的形状,需要字符串的格式(1:1 或者2:3这种比例形式),当然你可以设置为 auto 则不限制裁剪框的形状。

设置图片裁剪后,批量上传将不再生效。

图片裁剪完有两种选择,选择本地裁剪local或者服务端裁剪 server

  • 本地裁剪

你可以将 crop 设置为 local 来实现本地裁剪。本地裁剪完成后发送给服务端接口的图片便是已经裁剪好的图片。


轻量级Vue图片上传插件——Vue-core-image-Upload


  • 服务端裁剪

服务端裁剪是指将原图片和裁剪的参数一起发给后端,方便服务端保存原图,以及对原图的其他操作,而服务端能够接收到post的参数如下:


轻量级Vue图片上传插件——Vue-core-image-Upload

<vue-core-image-upload
crop-ratio="1:1"
:class="['btn', 'btn-primary']"
crop="server"
url="....php"
extensions="png,gif,jpeg,jpg"
text="Crop Image"
@imageuploaded="crpoServerImageUploaded">
</vue-core-image-upload>

调整图片

你可以设置 resize 来进行图片的缩放。

设置resize="local" 意味着图片的缩放将在本地进行。发给服务端的将会是大小调整完毕的后的图片。

<vue-core-image-upload
crop-ratio="1:1"
class="btn btn-primary"
resize="local"
url="**.php"
extensions="png,gif,jpeg,jpg"
text="Resize Image"
@imageuploaded="resizeLocalImageUploaded">
</vue-core-image-upload>


轻量级Vue图片上传插件——Vue-core-image-Upload

上传多个文件

  • multiple

你可以使用 multiple 属性设置为true来实现多文件的上传。需要注意的是,你设置了该属性后,服务端收到文件上传的字段数据会是一个数组。

  • multiple-size

你可以使用multiple-size来限制图片的数量,你可以限制上传文件的数量。

<vue-core-image-upload
class="btn btn-primary"
:crop="false"
@imageuploaded="imageUploded"
:max-file-size="5242880"
:multiple="true"
:multiple-size="4"
url="***.php" >
</vue-core-image-upload>

压缩图片

设置compress的数值,你可以在上传之前进行图片的本地压缩。其中 compress 为 0 表示不压缩,数据越大,图片的质量越差,且最大值不能大于100。


轻量级Vue图片上传插件——Vue-core-image-Upload

<vue-core-image-upload
:class="['btn', 'btn-primary']"
@imageuploaded="imageUploded"
:max-file-size="5242880"
compress="50" // 设置压缩比例
url="***/upload" >
</vue-core-image-upload>

向服务端发送数据

你可以设置data 来将一些附带的数据发送给服务端。 当然你也可以将一些数据包含在 header 中传递过去,你只需要绑定到 header即可。

您可能还会对下面的文章感兴趣: