zoukankan      html  css  js  c++  java
  • cropping API文档解析

    使用该图片剪裁插件首先要引入必要的js和css文件。
    <script src="jquery.js"></script><!-- jQuery is required -->
    <link  href="cropper.css" rel="stylesheet">
    <script src="cropper.js"></script>           
    调用插件
    可以使用$.fn.cropper方法来初始化该图片剪裁插件。 
    $('.container > img').cropper({
      aspectRatio: 16 / 9,
      crop: function(data) {
      // Output the result data for cropping image.
      }
    });   
    你可以通过$().cropper(options)方法来设置参数。如果你想改变全局默认参数,可以使用$.fn.cropper.setDefaults(options)方法。
    aspectRatio:类型:Number,默认值NaN。设置剪裁容器的比例。
    crop:类型:Function,默认值null。当改变剪裁容器或图片时的事件函数。
    preview:类型:String(jQuery选择器),默认值''。添加额外的元素(容器)的预览。
    注意:
    最大宽度是剪裁容器的初始化宽度
    最大高度是剪裁容器的初始化高度
    如果你设置了aspectRatio参数,确保预览容器具有相同的比例
    strict:类型:Boolean,默认值true。在strict模式中,canvas不能小于容器,剪裁容器不能再canvas之外。 responsive:类型:Boolean,默认值true。是否在窗口尺寸改变的时候重置cropper。 checkImageOrigin:类型:Boolean,默认值true。默认情况下,插件会检测图片的源,如果是跨域图片,图片元素会被添加crossOrigin class,并会为图片的url添加一个时间戳来使getCroppedCanvas变为可用。添加时间戳会使图片重新加载,以使跨域图片能够使用getCroppedCanvas。在图片上添加crossOrigin class会阻止在图片url上添加时间戳,及图片的重新加载。 background:类型:Boolean,默认值true。是否在容器上显示网格背景。 modal:类型:Boolean,默认值true。是否在剪裁框上显示黑色的模态窗口。 guides:类型:Boolean,默认值true。是否在剪裁框上显示虚线。 highlight:类型:Boolean,默认值true。是否在剪裁框上显示白色的模态窗口。 autoCrop:类型:Boolean,默认值true。是否在初始化时允许自动剪裁图片。 autoCropArea:类型:Number,默认值0.
    8(图片的80%)。0-1之间的数值,定义自动剪裁区域的大小。 dragCrop:类型:Boolean,默认值true。是否允许移除当前的剪裁框,并通过拖动来新建一个剪裁框区域。 movable:类型:Boolean,默认值true。是否允许移动剪裁框。 resizable:类型:Boolean,默认值true。是否允许改变剪裁框的大小。 zoomable:类型:Boolean,默认值true。是否允许放大缩小图片。 mouseWheelZoom:类型:Boolean,默认值true。是否允许通过鼠标滚轮来缩放图片。 touchDragZoom:类型:Boolean,默认值true。是否允许通过触摸移动来缩放图片。 rotatable:类型:Boolean,默认值true。是否允许旋转图片。 minContainerWidth:类型:Number,默认值200。容器的最小宽度。 minContainerHeight:类型:Number,默认值100。容器的最小高度。 minCanvasWidth:类型:Number,默认值0。canvas 的最小宽度(image wrapper)。 minCanvasHeight:类型:Number,默认值0。canvas 的最小高度(image wrapper)。 build:类型:Function,默认值null。build.cropper事件的简写方式。 built:类型:Function,默认值null。built.cropper事件的简写方式。 dragstart:类型:Function,默认值null。dragstart.cropper事件的简写方式。 dragmove:类型:Function,默认值null。dragmove.cropper事件的简写方式。 dragend:类型:Function,默认值null。dragend.cropper事件的简写方式。 zoomin:类型:Function,默认值null。zoomin.cropper事件的简写方式。 zoomout:类型:Function,默认值null。zoomout.cropper事件的简写方式。
    getContainerData():
    返回值:
    类型:Object
    属性:
    width:容器的当前宽度。
    height:容器的当前高度。 
    
    输出容器尺寸数据。
    getImageData():
    
    返回值:
    
    类型:Object
    属性:
    
    left:图片的左侧偏移。
    
    top:图片的上部偏移。 width:图片的宽度。 height:图片的高度。
    输出图片的位置和尺寸大小。 
    
    getCanvasData():
    
    返回值:
    
    类型:Object
    属性:
    
    left:canvas的左侧偏移。
    
    top:canvas的上部偏移。 width:canvas的宽度。 height:canvas的高度。 输出canvas(图片容器)的位置和尺寸大小。 
    etCanvasData(data):
    
    返回值:
    
    类型:Object
    属性:
    
    left:canvas的距离左侧新的偏移。
    
    top:canvas的距离上部新的偏移。 width:canvas新的宽度。 height:canvas新的高度。 改变canvas(图片容器)的位置和尺寸大小。
    getCropBoxData():
    
    返回值:
    
    类型:Object
    属性:
    
    left:剪裁区域距离左侧的偏移。 top:剪裁区域距离上部的偏移。 width:剪裁区域的宽度。
    height:剪裁区域的高度。 
    
    输出剪裁区域的位置和尺寸大小。
    setCropBoxData(data):
    返回值:
    
    类型:Object
    属性:
    
    left:剪裁区域距离左侧新的偏移。
    
    top:剪裁区域距离上部新的偏移。 width:剪裁区域新的宽度。 height:剪裁区域新的高度。 改变剪裁区域的位置和尺寸大小。 
    getCroppedCanvas([options]):
    参数(默认值):
    
    类型:Object
    属性:
    
    width:输出的canvas目标宽度。
    
    height:输出的canvas目标高度。 fillColor:canvas中填充的颜色。 返回值:
    类型:HTMLCanvasElement
    一个画有剪裁图片的canvas。
    
    浏览器支持:
    基本图像:需要Canvas的支持(IE9+)
    旋转图像:需要CSS3 animations Transforms3d的支持(IE10+)
    跨域图像:需要HTML5 CORS settings attributes的支持(IE11+)
    
    获取canvas绘制的剪裁图像。
    在这之后,你可以直接将canvas作为图片显示,或使用canvas.toDataURL方法获取图像的数据链接,或者使用canvas.toBlob方法获取一个blob,并通过FormData方法将它更新到服务器上(如果浏览器支持这些API)。
    
    $().cropper('getCroppedCanvas')
    
    $().cropper('getCroppedCanvas', {
    
     160,
    
    height: 90
    
    });
    复制代码
    setAspectRatio(aspectRatio):
    
    aspectRatio:
    
    类型:Number
    需要一个正整数。
    
    改变剪裁区域的比例。
    
    setDragMode([mode]):
    
    mode(可选项):
    
    类型:String
    默认值:''
    选项:'crop'或'move'
    
    改变拖拽模式。提示:你可以通过双击来改变"crop" 和 "move"模式。
    
    事件 
    
    build.cropper:当cropper对象开始加载图片的时候触发该事件。 built.cropper:当cropper对象构建完成时触发该事件。
    dragstart.cropper: 
    
    event.dragType:
    "crop":创建一个新的剪裁区域。
    "move":移动canvas。
    "zoom":通过触摸移动来缩放canvas。
    "e":调整剪裁区域东边的尺寸大小。
    "w":调整剪裁区域西边的尺寸大小。
    "s":调整剪裁区域南边的尺寸大小。
    "n":调整剪裁区域北边的尺寸大小。
    "se":调整剪裁区域东南边的尺寸大小。
    "sw":调整剪裁区域西南边的尺寸大小。
    "ne":调整剪裁区域东北边的尺寸大小。
    "nw":调整剪裁区域西北边的尺寸大小。
    "all":移动剪裁区域。
    
    该事件在剪裁区域发生改变时触发。
    
    相关的原始事件:mousedown、touchstart。 
    $('img').on('dragstart.cropper', function (e) {
    
    console.log(e.type); // dragstart
    
    console.log(e.namespace); // cropper
    
    console.log(e.dragType); // ...
    
    });
    复制代码
    
    dragmove.cropper:
    
    event.dragType:和dragstart.cropper相同。 当剪裁区域发生改变时触发。 相关的原始事件:mousemove、touchmove。 dragend.cropper: event.dragType:和dragstart.cropper相同。 当剪裁区域改变结束时触发。
    相关的原始事件:mouseup、mouseleave、touchend、touchleave和touchcancel。 
    
    zoomin.cropper:当cropper对象开始放大canvas时触发。
    zoomout.cropper:当cropper对象开始缩小canvas时触发。 

    来源:https://my.oschina.net/guopengfei/blog/742113

  • 相关阅读:
    BeanFactory 工厂模式
    中小型企业架构
    数据状态图
    好文章
    leetcode 最受欢迎的91道题目
    windows下安装mysql8并修改密码
    leetcode 1049 Last Stone Weight II(最后一块石头的重量 II)
    leetcode 910. Smallest Range II
    leetcode 908. Smallest Range I
    leetcode 900. RLE Iterator
  • 原文地址:https://www.cnblogs.com/wangyongx/p/12031156.html
Copyright © 2011-2022 走看看