0.0.2 • Published 3 years ago

vue-cutter-optimize v0.0.2

Weekly downloads
1
License
ISC
Repository
github
Last release
3 years ago

vue-cutter-optimize

简单易用的vue图片裁剪插件,支持旋转、缩放、平移,固定比例,固定尺寸,远程图片裁剪,只需要很少的代码就可以实现裁剪功能,也可以通过调整参数以适应你自己的业务需求。

==此插件是在原插件vue-img-cutter的基础上改进了,原插件适用于pc端,此插件适用于手机端==

GitHub stars GitHub forks npm npm

特色:


  • 兼容IE9+,MSEdge,Chrome,Firefox
  • 两种展现形式,行内或弹窗
  • 可旋转、缩放图片
  • 任意比例、大小裁剪
  • 固定比例、大小裁剪
  • 支持远程图片裁剪、跨域设置

插件截图:


插件截图

演示地址:


https://ihtmlcss.com/demo/dist/#/croptool

项目地址:


Github:https://github.com/azhaaa/vue-cutter-optimize

原Github:https://github.com/acccccccb/vue-img-cutter

如果此项目对你有帮助,请给我一个star :)

使用方法:


  1. 安装
npm install vue-cutter-optimize --save-dev
  1. 将ImgCutter.vue文件引入项目:
import cutterOptimize from 'vue-cutter-optimize'
export default {
        components:{
            cutterOptimize
        },
...
}
  1. 在页面中使用:
<cutterOptimize v-on:cutDown="cutDown"></cutterOptimize>
  1. 可使用solt
<cutterOptimize v-on:cutDown="cutDown">
    <button slot="open">选择图片</button>
</cutterOptimize>
  1. 远程、跨域裁剪(兼容IE9)

需要自己写一个方法来触发裁剪工具弹出

在方法中先将图片上传至服务器,拿到返回的url后创建一个obj,然后将对象传入裁剪工具

只需要传入图片url和图片名称

// 传入的obj必须包含这四个属性
let obj = {
    name:'1.jpg',//远程图片名称
    src:'http://url/1.jpg',//远程图片url
    //width:200,//远程图片的原始宽度 2.1.9版本后不需要
    //height:200,//远程图片的原始高度  2.1.9版本后不需要
}
forIe9:function(){
	// 传入name,src name中必须包含后缀名
	this.$refs.imgCutterModal.handleOpen({
        name:"image.jpg",
        src:"http://imageServ.com/image.jpg",
    });
}

参数说明:


属性名作用类型必填默认值
isModal是否为弹窗模式Booleantrue
showChooseBtn是否显示选择图片按钮Booleantrue
lockScroll是否在Dialog出现时将body滚动锁定Booleantrue
label默认打开裁剪工具按钮的显示文字String选择图片
boxWidth裁剪工具宽度Number800
boxHeight裁剪工具高度Number400
cutWidth默认裁剪宽度Number200
cutHeight默认裁剪高度Number200
tool是否显示工具栏Booleantrue
toolBgc工具栏背景色String(例: "#fff")#fff
sizeChange是否能够调整裁剪框大小Booleantrue
moveAble能否调整裁剪区域位置Booleantrue
originalGraph是否直接裁剪原图Booleanfalse
crossOrigin是否设置跨域,需要服务器做相应更改Booleanfalse
crossOriginHeader设置跨域信息crossOrigin为true时才生效String''
rate图片比例String(例: "4:3")-
WatermarkText水印文字String''
WatermarkTextFont水印文字字体String'12px Sans-serif'
WatermarkTextColor水印文字颜色String'#fff'
WatermarkTextX水印文字水平位置Number0.95
WatermarkTextY水印文字垂直位置Number0.95
smallToUpload如果裁剪尺寸固定且图片尺寸小于裁剪尺寸则不裁剪直接返回文件Booleanfalse
saveCutPosition是否保存上一次裁剪位置及大小Booleanfalse
scaleAble是否允许滚轮缩放图片Booleantrue

支持slot,在组件内部使用带有slot="open"属性的元素即可自定义打开组件的按钮

钩子函数:

属性名作用类型必填返回值
cutDown完成截图后要执行的方法FunctionObject
error错误回调FunctionError object
onChooseImg选择图片后FunctionObject
onPrintImg在画布上绘制图片FunctionObject
onClearAll清空画布Functionnull

插槽(slot):

插槽名称作用
open 或 openImgCutter弹出裁剪框
choose选择本地图片
cancel取消/清空
confirm确认裁剪
ratio工具栏:宽高比
scaleReset工具栏: 重置缩放
turnLeft工具栏: 向左旋转
turnRight工具栏: 向右旋转
reset工具栏: 重置旋转
flipHorizontal工具栏: 水平翻转
flipVertically工具栏: 垂直翻转

返回值 @cutDown:


属性名类型
fileName文件名
filefile类型的文件对象(IE部分版本可能不会返回)
blobblob类型的文件对象(IE部分版本可能不会返回)
dataURLdataURL