轻量级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-uploadclass="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即可。

版权声明:飞鱼 发表于 2020-07-19 12:05:22。
转载请注明:轻量级Vue图片上传插件——Vue-core-image-Upload | HelloWorld.La

暂无评论

暂无评论...