vue-image-handler

一个支持图片自定义裁剪和去底色的插件

github地址（感谢star）

在线预览

安装

1
2
3
4
npm install vue-image-handler
# 或者
yarn add vue-image-handler

vue项目中使用

1
2
3
4
5
6
7
8
9
10
// main.js
// 全局安装使用
import VueImageHandler from 'vue-image-handler'
Vue.use(VueImageHandler)

// 页面单独引入使用
import VueImageHandler from 'vue-image-handler'
// ...省略其他代码
components: { VueImageHandler }

Attributes

名称 功能 默认值 类型 可选值
canvas-width 画布的宽度 380px String
canvas-height 画布的高度 252px String
img-file 图片资源 Blob/File/String
wipe-color 要去除的底色 String white/black
color-diff 去底色的容差值 20 Number 1-100
option 其他配置(具体配置参数见下表) Object

Option

名称 功能 默认值 类型 可选值
outputQuality 处理后的图片质量 1 Number 0.1-1
outputType 处理后的图片格式 png String jpeg/png/webp
canMove 图片是否可以移动 true Boolean true/false
fixedBox 固定截图框大小 false Boolean true/false
cropWidth 截图框宽 380 Number/String 380
cropHeight 截图框高 252 Number/String 252

Events（通过this.$refs[your ref name].[method]调用）

方法名 说明 参数
rotate 旋转90°
download 下载处理后的图片
getImageUrl 获取处理后的图片Base64
clear 清空画布和预览图
refresh 刷新画布

快速上手

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
<template>
  <VueImageHandler
   ref="vueImageHandler"
   :canvas-width="width"
   :canvas-height="height"
   :img-file="imgFile"
   :wipe-color="wipeColor"
   :color-diff="colorDiff"
  />
</template>
<script>
 export default {
  data() {
    return {
      imgFile: 'https://cdn.jsdelivr.net/gh/cong1223/cloudimg@master/img/20210613092202.png',
      wipeColor: '',
      colorDiff: 20,
      width: '380px',
      height: '252px'
    };
  },
  methods: {
   changeCanvasWidth(e) { // 动态修改画布和预览图的宽度
      this.width = e.target.value + 'px';
      this.$refs.vueImageHandler.refresh();
    },
    changeCanvasHeight(e) { // 动态修改画布和预览图的高度
      this.height = e.target.value + 'px';
      this.$refs.vueImageHandler.refresh();
    },
    changeWipeColor(e) { // 动态修改要去的底色（white or black）
      this.wipeColor = e;
    },
    changeColorDiff(e) { // 动态修改去底色的容差值
      this.colorDiff = +e.target.value;
    },
    pickImage() { // 从本地选择图片（input file）
      this.$refs.filElem.dispatchEvent(new MouseEvent('click'));
    },
    handleRotate() { // 原图旋转
      this.$refs.vueImageHandler.rotate();
    },
    getFile() { // 从本地选择图片后获取文件信息
      const inputFile = this.$refs.filElem.files[0];
      if (inputFile) {
        this.imgFile = inputFile;
        this.$refs.filElem.value = '';
      } else {
        return;
      }
    },
    download() { // 下载图片
      this.$refs.vueImageHandler.download();
    },
    getUrl() {
      this.$refs.vueImageHandler.getImageUrl(url => {
        console.log('处理后的图片', url);
      });
    },
    clear() { // 清空画布
      this.$refs.vueImageHandler.clear();
    }
  }
 }
</script>

更新日志

1.2.8

1
支持页面内单独引用：`import VueImageHandler from 'vue-image-handler'`

即将更新

1. download和getImageUrl支持自定义图片格式输出