基于jQuery的图片剪切插件

第一步：建立工作区间

首先，我们要位我们这个教程建立一个工作区间，建立如图所示的文件层次结构，以及新建相应的空文件。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title></title>
<script src="Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>
<link href="resources/css/style.css" rel="stylesheet" type="text/css" />
<link href="resources/js/imageCrop/jquery.imagecrop.css" rel="stylesheet" type="text/css" />
<script src="resources/js/imageCrop/jquery.imagecrop.js" type="text/javascript"></script>
</head>
<body>
<form id="form1" runat="server">
<div id="wrapper">
<h1>
Jquery Image Croping plug-in</h1>
<div class="image-decorator">
<img alt="Jquery Image Croping plug-in" height="360px" id="example" src="resources/images/example.JPG"
width="480" /></div><!--图片修饰层-->
</div><!--#包裹层 -->
</form>
</body>
</html>
[/code]
style.css


代码如下:

* {
margin : 0;
outline : 0;
padding : 0;
}
/*初始化网页样式*/
body {
background-color : #ededed;
color : #646464;
font-family : 'Verdana', 'Geneva', sans-serif;
font-size : 12px;
text-shadow : 0 1px 0 #ffffff;
}
h1 {
font-size : 24px;
font-weight : normal;
margin : 0 0 10px 0;
}
div#wrapper {
margin : 25px 25px 25px 25px;
}
/*选择id为wrapper的div*/
div.image-decorator {
-moz-border-radius : 5px 5px 5px 5px;/*针对火狐的浏览器的盒子的锐化*/
-moz-box-shadow : 0 0 6px #c8c8c8;/*针对火狐的浏览器的盒子的边框阴影处理*/
-webkit-border-radius : 5px 5px 5px 5px;/*WebKit 是一个开源的浏览器引擎*/
-webkit-box-shadow : 0 0 6px #c8c8c8;
background-color : #ffffff;
border : 1px solid #c8c8c8;
border-radius : 5px 5px 5px 5px;
box-shadow : 0 0 6px #c8c8c8;
display : inline-block;/*将对象呈递为内联对象，但是对象的内容作为块对象呈递。旁边的内联对象会被呈递在同一行内，允许空格。支持的浏览器有：Opera、Safari*/
height : 360px;
padding : 5px 5px 5px 5px;
width : 480px;
}

以上我们通过改变背景颜色和设置一些基本的样式，使我们的页面更具有可观赏性。
第三步：写一个基本的jQuery插件
让我们开始写一个基本的jQuery插件吧，在写之前，如果读者你从未有写jQuery插件的经历，建议先看看官方给出的插件教程（http://docs.jquery.com/Plugins/Authoring），这个是英文版的，中文版的没找的，写者打算翻译，敬请期待。
打开/resources/js/imageCrop/jquery.imagecrop.js，并且加入如下图所示的js代码


代码如下:

//一般情况下请将所写的插件代码包含在‘(function($) { // 插件代码在这里 }) (jQuery);'
(function($) {
$.imageCrop = function(object, customOptions) {};
$.fn.imageCrop = function (customOptions) {
//Iterate over each object
//对每一个对象进行迭代
this.each(function () {
var currentObject = this,
image = new Image();
//当对象加载完毕时，给予附加上imageCrop剪切的功能
image.onload = function () {
$.imageCrop(currentObject, customOptions);
};
//重设图片的地址，因为有时被缓存的图像不能被很快的加载
image.src = currentObject.src;
});
//除非你的插件返回一个确定的值，那么通常情况下要求函数返回‘this'关键字
//以此来保持编程的链式化
return this;
};
}) (jQuery);

我们刚刚扩展了jQuery，通过在jQuery.fn这个对象上新添加一个方法属性。现在我们完成了对每一个对象进行迭代并当其加载完毕时为其附上imageCrop功能的基本插件。注意到被缓存的图片可能不会被很快的下载，所以重置了它的图片地址。

第四步：加入可定制的选择

通过可以定制的选择，使得对用户来说有了更多的选择以及使插件更加具有灵活性。（备注：以下代码均按照顺序来的）


代码如下:

//将插件的选项封装在一个常量对象中，远远好于传递一长串参数来传递。
//这样使得可以在插件默认的情况下进行扩展
var defaultOptions = {
allowMove: true,
allowResize: true,
allowSelect: true,
minSelect: [0, 0],
outlineOpacity: 0.5,
overlayOpacity: 0.5,
selectionPosition: [0, 0],
selectionWidth: 0,
selectionHeight: 0
};

// 将选项设为默认选项
var options = defaultOptions;

// 然后将其和客户定制的选项合并
setOptions(customOptions);

以上我们通过定义一个包含默认选项的数组，然后通过使用setOption函数来实现将默认选项和定制选项进行合并。现在让我们来写这个合并函数体


代码如下:

// 将默认选项和客户定制的选项合并
function setOptions(customOptions) {
options = $.extend(options, customOptions);
};

$.extend()函数实现了将两个或者多个对象合并到第一个对象中的功能。

选项

下面的列表解释了插件中的每一个选项

allowMove – 指定选择区是否可以移动（默认的值是true.）
allowResize – 指定选择区是否可以被重新指定大小（默认的值是true）
allowSelect – 指定用户是否可以重新指定选择区（默认的值是true）
minSelect – 一个新的选择区最小的大小（默认的大小是[0, 0]）
outlineOpacity – 轮廓的透明度（默认的值是0.5）
overlayOpacity – 覆盖层的透明度（默认的值是0.5）
selectionPosition – 选择区得位置（默认的是[0, 0]）
selectionWidth – 选择区得宽度（默认的值是0）
selectionHeight – 选择区的长度（默认的值是0）
第五步：建立图像层

这一步我们将改变文档的结构，以此来为下一步做准备：插件的表面

首先我们要初始化图像层，然后初始化化图像包含层


代码如下:

// 初始化图像层
var $image = $(object);

// 初始化一个图像支持层
var $holder = $('<div />')
.css({
position: 'relative'
})
.width($image.width())
.height($image.height());

// imag包含在holder层里面 .wrap()函数

$image.wrap($holder)
.css({
position: 'absolute'
});

　　正如你所见，包含层和图像具有同样的大小并且包含层和图像是相对定位。然后我们使用.wrap函数使得图像包含在其中

在图像的上面是覆盖层：


代码如下:

//初始化一个覆盖层，并将其置于图像之上
var $overlay = $('<div id="image-crop-overlay" />')
.css({
opacity: options.overlayOpacity,
position: 'absolute'
})
.width($image.width())
.height($image.height())
.insertAfter($image);

　　这个层同样和图像一样大，但是是绝对定位。我们从options.outlineOpacity得到透明度。这个元素拥有一个Id，所以我们可以改变通过插件的css来改变它的样式。在最后我们用.insertAfter($image)方法将覆盖层恰好放在图像层的下面。

下面一层是触犯器层


代码如下:

// 初始化一个触发器层，并将其放在覆盖层的上面
var $trigger = $('<div />')
.css({
backgroundColor: '#000000',
opacity: 0,
position: 'absolute'
})
.width($image.width())
.height($image.height())
.insertAfter($overlay);

　　这一次对于用户来说是不可见的，但是它会处理一些事件。

接下来是边框层和选择层


代码如下:

// 初始化一个边框层，将其放在触发器层的上面
var $outline = $('<div id="image-crop-outline" />')
.css({
opacity: options.outlineOpacity,
position: 'absolute'
})
.insertAfter($trigger);

// 初始化一个选择层，将其置于边框层的上面
var $selection = $('<div />')
.css({
background: 'url(' + $image.attr('src') + ') no-repeat',
position: 'absolute'
})
.insertAfter($outline);

　　.attr()方法是用来返回某个特定的属性的值，我们用它来得到图像的地址，并将其作为选择层的背景

绝对定位在相对定位里面

一个相对定位的元素可以控制绝对定位的元素，使得绝对定位的元素在相对定位的元素的里面。这也算为什么包含层是相对定位，而所有的它的子元素都是绝对定位

第六步：更新界面

　　　　　　首先我们要初始为一些全局变量


代码如下:

//初始化全局变量
var selectionExists,
selectionOffset = [0, 0],
selectionOrigin = [0, 0];

　　selectionExists会告知我们是否存在着一个选择区域，selectionOffset会包含相对于起点的偏移量，selectionOrigin会包含选择区域的起点

下面的条件用于当插件被加载时选择区域就存在


代码如下:

//指示选择区域的大小是否比最小的大，然后再根据它来设定选择区域是否存在
if (options.selectionWidth > options.minSelect[0] &&
options.selectionHeight > options.minSelect[1])
selectionExists = true;
else
selectionExists = false;
　　现在我们将调用updateInterface来初始化插件的界面

//第一次调用‘uploadInterface'函数来初始化插件的界面
updateInterface();