jQuery Jcrop API参数说明(中文版)

Jcrop是一个jQuery图片裁剪插件，它能为你的WEB应用程序快速简单地提供图片裁剪的功能。特点如下：

对所有图片均unobtrusively（无侵入的，保持DOM简洁）
支持宽高比例锁定
支持 minSize/maxSize设置
支持改变选区或移 动选区时的回调（Callback）
支持用键盘微调选区
通过API创建互动，比如动画效果
支持CSS样式
版本及Demo

jQuery v1.5.1+
Jcrop v0.9.9
Demo地址：http://code.ciaoca.com/jquery/jcrop/demo/
下载地址：http://deepliquid.com/content/Jcrop_Download.html
options 参数说明（可选）

参数名	默认值	参数说明
allowSelect	true	允许新选框
allowMove	true	允许选框移动
allowResize	true	允许选框缩放
trackDocument	true
baseClass	“jcrop”	基础样式名前缀。说明：class=”jcrop-holder”，更改的只是其中的 jcrop。
addClass	null	添加样式。假设class名为 “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文件

[html] view plain copy 在CODE上查看代码片派生到我的代码片

载入JavaScript文件

[html] view plain copy 在CODE上查看代码片派生到我的代码片
“` python

给图像标签加上ID

[html] view plain copy 在CODE上查看代码片派生到我的代码片

调用Jcrop

[javascript] view plain copy 在CODE上查看代码片派生到我的代码片
$(“#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]