jQuery 图像裁剪插件Jcrop的简单使用

【options 参数说明】

名称	默认值	说明
allowSelect	true	允许新选框
allowMove	true	允许选框移动
allowResize	true	允许选框缩放
trackDocument	true
baseClass	"jcrop"	基础样式名前缀。说明：class="jcrop-holder"，更改的只是其中的 jcrop。
addClass	null	添加样式会。例：假设值为 "test"，那么会添加样式到 class="test jcrop-holder"
bgColor	"black"	背景颜色。颜色关键字、HEX、RGB 均可。
bgOpacity	0.6	背景透明度
bgFade	false	使用背景过渡效果
borderOpacity	0.4	选框边框透明度
handleOpacity	0.5	缩放按钮透明度
handleSize	9	缩放按钮大小
handleOffset	5	缩放按钮与边框的距离
aspectRatio	0	选框宽高比。说明：width/height
keySupport	true	支持键盘控制。按键列表：上下左右（移动）、Esc（取消）、Tab（跳出裁剪框，到下一个）
cornerHandles	true	允许边角缩放
sideHandles	true	允许四边缩放
drawBorders	true	绘制边框
dragEdges	true	允许拖动边框
fixedSupport	true
touchSupport	null
boxWidth	0	画布宽度
boxHeight	0	画布高度
boundary	2	边界。说明：可以从边界开始拖动鼠标选择裁剪区域
fadeTime	400	过度效果的时间
animationDelay	20	动画延迟
swingSpeed	3	过渡速度
minSelect	[0,0]	选框最小选择尺寸。说明：若选框小于该尺寸，则自动取消选择
maxSize	[0,0]	选框最大尺寸
minSize	[0,0]	选框最小尺寸
onChange	function(){}	选框改变时的事件
onSelect	function(){}	选框选定时的事件
onRelease	function(){}	取消选框时的事件

【使用方法】

载入 CSS 文件

<link rel="stylesheet" href="css/jquery.Jcrop.css">

载入 JavaScript 文件

<script src="js/jquery.js"></script>  <script src="js/jquery.Jcrop.js"></script>

给 IMG 标签加上 ID

<img id="element_id" src="pic.jpg">

调用 Jcrop

$("#element_id").Jcrop();

【API 接口】

名称	说明
setImage(string)	设定（或改变）图像。例：jcrop_api.setImage("newpic.jpg")
setOptions(object)	设定（或改变）参数，格式与初始化设置参数一样
setSelect(array)	创建选框，参数格式为：[x,y,x2,y2]
animateTo(array)	用动画效果创建选框，参数格式为：[x,y,x2,y2]
release()	取消选框
disable()	禁用 Jcrop。说明：已有选框不会被清除。
enable()	启用 Jcrop
destroy()	移除 Jcrop
tellSelect()	获取选框的值（实际尺寸）。例子：console.log(jcrop_api.tellSelect())
tellScaled()	获取选框的值（界面尺寸）。例子：console.log(jcrop_api.tellScaled())
getBounds()	获取图片实际尺寸，格式为：[w,h]
getWidgetSize()	获取图片显示尺寸，格式为：[w,h]
getScaleFactor()	获取图片缩放的比例，格式为：[w,h]

同事推荐了Jcrop这个插件，到它的官方站点http://deepliquid.com/content/Jcrop.html下载了最新版的压缩包，压缩包中包括了Jcrop的几个demo文件，关键的Jcrop.js文件和jQuery.Jcrop.css文件。基本上来说参照它的几个demo文件就可以学会使用这个插件了。晚上正好学习研究了下，现简单总结如下，也方便下英文不好的朋友们。使用插件必须条件：引入jQuery.js文件，引入jQuery.Jcrop.js文件，引入JQuery.Jcrop.css文件。 1.最基本使用方法 html代码部分：

代码如下:

js部分：

代码如下:

      $( 
       function() 
       { 
       $("#demoImage").Jcrop(); 
       } 
       ); 
       
    

这样就可以在图片上进行裁剪了。 2.得到选中区域的坐标以及回调函数 html代码部分如下：

代码如下:

      <img src="demo_files/flowers.jpg" id="demoImage" /> 
       <label>x1</label><input type="text" id="txtX1" /> 
       <label>y1</label><input type="text" id="txtY1" /> 
       <label>x2</label><input type="text" id="txtX2" /> 
       <label>y2</label><input type="text" id="txtY2" /> 
       <label>width</label><input type="text" id="txtWidth" /> 
       <label>height</label><input type="text" id="txtHeight" /> 
       
    

js代码部分如下：

代码如下:

      $( 
       function() { 
       //事件处理 
       $("#demoImage").Jcrop( 
       { 
       onChange:showCoords, //当选择区域变化的时候，执行对应的回调函数 
       onSelect:showCoords //当选中区域的时候，执行对应的回调函数 
       } 
       ); 
       } 
       ); 
       function showCoords(c) { 
       $("#txtX1").val(c.x); //得到选中区域左上角横坐标 
       $("#txtY1").val(c.y); //得到选中区域左上角纵坐标 
       $("#txtX2").val(c.x2); //得到选中区域右下角横坐标 
       $("#txtY2").val(c.y2); //得到选中区域右下角纵坐标 
       $("#txtWidth").val(c.w); //得到选中区域的宽度 
       $("#txtHeight").val(c.h); //得到选中区域的高度 
       } 
    

3.常用选项设置 aspectRatio:选中区域按宽/高比，为1表示正方形。 minSize:最小的宽，高值。 maxSize:最大的宽，高值。 setSelect:设置初始选中区域。 bgColor:背景颜色 bgOpacity:背景透明度。 allowResize:是否允许改变选中区域大小。 allowMove:是否允许移动选中区域。举例如下：

代码如下:

      $( 
       function() { 
       $("#demoImage").Jcrop({ 
       aspectRatio: 1, //选中区域宽高比为1，即选中区域为正方形 
       bgColor:"#ccc", //裁剪时背景颜色设为灰色 
       bgOpacity:0.1, //透明度设为0.1 
       allowResize:false, //不允许改变选中区域的大小 
       setSelect:[0,0,100,100] //初始化选中区域 
       } 
       ); 
       } 
       ); 
    

4.api用法

代码如下:

      var api = $.Jcrop("#demoImage"); 
       api.disable(); //设置为禁用裁剪效果 
       api.enable(); //设置为启用裁剪效果 
       api.setOptions({allowResize:false});//设置相应配置 
       api.setSelect([0,0,100,100]); //设置选中区域 
       
    

jQuery 图像裁剪插件Jcrop的简单使用

【options 参数说明】

【使用方法】

载入 CSS 文件

载入 JavaScript 文件

给 IMG 标签加上 ID

调用 Jcrop

【API 接口】

jQuery 图像裁剪插件Jcrop的简单使用

你可能感兴趣的:(jquery)