jQuery 图片剪裁插件使用之 imgAreaSelect

插件主页：http://odyniec.net/projects/imgareaselect/

官方网站上说明支持的浏览器：The plugin works in all major browsers, including Firefox 2+, Opera 9.5+, Google Chrome, Safari 3+, and Internet Explorer 6+.

插件的主要功能包括：

1. 可以选取固定比例 或 任意比例的选区

2. 可以设置选区的长宽最大最小限值

3. 可以设默认显示初始选区

4. 可以用鼠标移动选区的位置，不能移出原始图片的范围

5. 可以用鼠标对选区进行缩放 ( 鼠标按住8个点 ( handles: true ) 其中1点不放移动：左上、左、左下、右上、右、右下 )

6. 可以显示选区预览图

7. 可以显示选区的各点 ( 左上和右下 ) 坐标和长度与宽度

下载的插件包大小 56.4 k，插件包中不含 demo，只包含 css 文件夹、 script 文件夹和两个 LICENSE 文件。

一.创建demo：

在根目录下创建demo.html ，在头部链接引入 css 文件和 js 文件

  <link rel="stylesheet" type="text/css" href="css/imgareaselect-default.css" />
  <script type="text/javascript" src="scripts/jquery.min.js"></script>
  <script type="text/javascript" src="scripts/jquery.imgareaselect.js"></script>

注：插件包中所带的 jquery 版本为 jQuery v1.9.0

html 结构包括 原图、选区缩略图和信息。原图和选区预览图：

<!-- 原图 -->
<div>
     <img id="photo" src="data:images/pic3.jpg"/>
</div>

<!-- 选区预览图 -->
<div id="preview" style="width: 100px; height: 100px; overflow: hidden;">
     <img style="position: relative;">
</div>

信息，包括选区起点和终点的横纵坐标、选区的长度和高度：

<table style="margin-top: 1em;">
          <thead>
            <tr>
              <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                坐标
              </th>
              <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                尺寸
              </th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td style="width: 10%;"><b>X<sub>1</sub>:</b></td>
                  <td style="width: 30%;"><input type="text" id="x1" value="-"></td>
                  <td style="width: 20%;"><b>Width:</b></td>
                <td><input type="text" value="-" id="w"></td>
            </tr>
            <tr>
              <td><b>Y<sub>1</sub>:</b></td>
              <td><input type="text" id="y1" value="-"></td>
              <td><b>Height:</b></td>
              <td><input type="text" id="h" value="-"></td>
            </tr>
            <tr>
              <td><b>X<sub>2</sub>:</b></td>
              <td><input type="text" id="x2" value="-"></td>
              <td></td>
              <td></td>
            </tr>
            <tr>
              <td><b>Y<sub>2</sub>:</b></td>
              <td><input type="text" id="y2" value="-"></td>
              <td></td>
              <td></td>
            </tr>
          </tbody>
</table>

js 设置：

 <script type="text/javascript">

     function preview(img, selection) {
         if (!selection.width || !selection.height)
             return;

         //预览图尺寸等比例缩放，以100为临界，当在原图中选定的区域大于100px时，预览图中图像缩小；当在原图中选定的区域小于100px时，预览图中图像放大；selection为选区
         var scaleX = 100 / selection.width;
         var scaleY = 100 / selection.height;

         $('#preview img').css({
             width: Math.round(scaleX * 400), //原图宽400
             height: Math.round(scaleY * 300), //原图高300
             marginLeft: -Math.round(scaleX * selection.x1),
             marginTop: -Math.round(scaleY * selection.y1)
         });

         $('#x1').val(selection.x1);
         $('#y1').val(selection.y1);
         $('#x2').val(selection.x2);
         $('#y2').val(selection.y2);
         $('#w').val(selection.width);
         $('#h').val(selection.height);
     }

     $(function () {

         //onSelectChange: preview 使用缩略图
         //模式一.选区宽高比为1:1
         //$('#photo').imgAreaSelect({ aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //模式二.选区最大宽度200，最大高度150
         //$('#photo').imgAreaSelect({ maxWidth: 200, maxHeight: 150, handles: true, fadeSpeed: 200, onSelectChange: preview });

         //模式三.选区的起点和终点初始坐标
         //$('#photo').imgAreaSelect({ x1: 116, y1: 77, x2: 276, y2: 237, aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //模式四.任意尺寸的选区
         $('#photo').imgAreaSelect({ handles: true, fadeSpeed: 200, onSelectChange: preview });

         //缩略图的图片
         $("#preview img").attr("src",$("#photo").attr("src"));
     });
 </script>

二. 预览图的成像原理：

在 html 中，预览窗口的宽度和高度设各置成了 100px ，scaleX 和 scaleY 分别表示预览窗口中图像的缩放比例，以预览窗口的长和高的缩放比等于 100px 除以 原始图像上选区的长和宽，这样当选区的长和宽小于 100px 时，预览图片会被等比放大

$('#preview img').css({
        width: Math.round(scaleX * 400), //原图宽400
        height: Math.round(scaleY * 300), //原图高300
        marginLeft: -Math.round(scaleX * selection.x1),
        marginTop: -Math.round(scaleY * selection.y1)
});

当选区的长和宽大于 100px 时，预览图片会被等比缩小：

三. 在 js 中，可以设置 4 种选区模式：

1. 固定选区长宽比，可以设置成 1:1 , 4:3 等模式，如图：

2. 设置选区的最大 ( 最小 ) 宽度和最大 ( 最小 ) 高度

3. 初始时默认显示选区，并给定初始选区的各点 ( 左上和右下 ) 坐标

4. 选取任意尺寸的选区

完整demo.html:

 <!DOCTYPE html>
 <html>
 <head>
 <meta charset="utf-8">
 <title>imgAreaSelect demo1</title>
   <link rel="stylesheet" type="text/css" href="css/imgareaselect-default.css" />
   <script type="text/javascript" src="scripts/jquery-1.8.3.min.js"></script>
   <script type="text/javascript" src="scripts/jquery.imgareaselect.js"></script>

   <script type="text/javascript">

     function preview(img, selection) {
         if (!selection.width || !selection.height)
             return;

         //预览图尺寸等比例缩放，以100为临界，当在原图中选定的区域大于100px时，预览图中图像缩小；当在原图中选定的区域小于100px时，预览图中图像放大；
         var scaleX = 100 / selection.width;
         var scaleY = 100 / selection.height;

         $('#preview img').css({
             width: Math.round(scaleX * 400), //原图宽400
             height: Math.round(scaleY * 300), //原图高300
             marginLeft: -Math.round(scaleX * selection.x1),
             marginTop: -Math.round(scaleY * selection.y1)
         });

         $('#x1').val(selection.x1);
         $('#y1').val(selection.y1);
         $('#x2').val(selection.x2);
         $('#y2').val(selection.y2);
         $('#w').val(selection.width);
         $('#h').val(selection.height);
     }

     $(function () {

         //onSelectChange: preview 使用缩略图
         //选区宽高比为1:1
         //$('#photo').imgAreaSelect({ aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //选区最大宽度200，最大高度150
         //$('#photo').imgAreaSelect({ maxWidth: 200, maxHeight: 150, handles: true, fadeSpeed: 200, onSelectChange: preview });

         //选区的起点和终点初始坐标
         //$('#photo').imgAreaSelect({ x1: 116, y1: 77, x2: 276, y2: 237, aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //任意尺寸的选区
         $('#photo').imgAreaSelect({ handles: true, fadeSpeed: 200, onSelectChange: preview });

         //缩略图的图片
         $("#preview img").attr("src",$("#photo").attr("src"));
     });
 </script>
 </head>

 <body>

     <div id="container">

         <!-- 原图 -->
         <div>
             <img id="photo" src="data:images/pic3.jpg"/>
         </div>

         <!-- 选区缩略图 -->
         <div id="preview" style="width: 100px; height:100px; overflow: hidden;">
             <img style="position: relative;">
         </div>

         <!-- 信息 -->
         <table style="margin-top: 1em;">
           <thead>
             <tr>
               <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                 坐标
               </th>
               <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                 尺寸
               </th>
             </tr>
           </thead>
           <tbody>
             <tr>
               <td style="width: 10%;"><b>X<sub>1</sub>:</b></td>
                   <td style="width: 30%;"><input type="text" id="x1" value="-"></td>
                   <td style="width: 20%;"><b>Width:</b></td>
                 <td><input type="text" value="-" id="w"></td>
             </tr>
             <tr>
               <td><b>Y<sub>1</sub>:</b></td>
               <td><input type="text" id="y1" value="-"></td>
               <td><b>Height:</b></td>
               <td><input type="text" id="h" value="-"></td>
             </tr>
             <tr>
               <td><b>X<sub>2</sub>:</b></td>
               <td><input type="text" id="x2" value="-"></td>
               <td></td>
               <td></td>
             </tr>
             <tr>
               <td><b>Y<sub>2</sub>:</b></td>
               <td><input type="text" id="y2" value="-"></td>
               <td></td>
               <td></td>
             </tr>
           </tbody>
         </table>

     </div>

 </body>
 </html>

四 . 如果需要多个尺寸的预览窗口 ( 比如 100px * 100px , 60px * 60px , 30px * 30px  )，则可以设置多种缩放比例：

var scaleX = 100 / selection.width;
var scaleY = 100 / selection.height;

var scale2X = 60 / selection.width;
var scale2Y = 60 / selection.height;

var scale3X = 30 / selection.width;
var scale3Y = 30 / selection.height;

然后 html 和 css 分别设置每个窗口即可：

五. 重新选择选区

html 增加：

<!-- 重置选区 -->
<input type="button" id="reselect" value="重新选择" />

js $(function(){}) 中增加：

//重新选择
$("#reselect").click(function(){

        $('#photo').data('imgAreaSelect').remove();
        $('#photo').removeData('imgAreaSelect');
        $('#photo').imgAreaSelect({ aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });
});

如图：

六 . 此插件的选区预览图只能在确定长宽比的情况下正常预览，在截取任意尺寸的选区时将得不到正确比例的预览图，如果要实现任意长宽比的选区都能正常显示，可以修改代码：

预览图部分 html：

<!-- 选区预览图 -->
<div id="preview" style="display:none; overflow: hidden;">
    <img style="position: relative;">
</div>

初始的预览图外围 div 设置了 display:none

js 的 preview() 函数修改如下：

 function preview(img, selection) {
         if (!selection.width || !selection.height)
             return;

         $('#preview img').css({

              marginLeft: -Math.round(selection.x1),
              marginTop: -Math.round(selection.y1)
         });

         $("#preview").css({"width":selection.width,"height":selection.height}).show();

         $('#x1').val(selection.x1);
         $('#y1').val(selection.y1);
         $('#x2').val(selection.x2);
         $('#y2').val(selection.y2);
         $('#w').val(selection.width);
         $('#h').val(selection.height);
 }

把预览图尺寸等比缩放的语句删除，预览图的上边距和左边距分别是选区左上角的横纵坐标，然后设置预览图外围 div 的宽度和高度直接设置为选区的宽度和高度并且显示，此时并不固定比例的选区的预览图也能正常预览，如图：

此时的完整 demo.html:

 <!DOCTYPE html>
 <html>
 <head>
 <meta charset="utf-8">
 <title>imgAreaSelect demo1</title>
   <link rel="stylesheet" type="text/css" href="css/imgareaselect-default.css" />
   <script type="text/javascript" src="scripts/jquery-1.8.3.min.js"></script>
   <script type="text/javascript" src="scripts/jquery.imgareaselect.js"></script>

   <script type="text/javascript">

     function preview(img, selection) {
         if (!selection.width || !selection.height)
             return;

         $('#preview img').css({

              marginLeft: -Math.round(selection.x1),
              marginTop: -Math.round(selection.y1)
         });

         $("#preview").css({"width":selection.width,"height":selection.height}).show();

         $('#x1').val(selection.x1);
         $('#y1').val(selection.y1);
         $('#x2').val(selection.x2);
         $('#y2').val(selection.y2);
         $('#w').val(selection.width);
         $('#h').val(selection.height);
     }

     $(function () {

         //onSelectChange: preview 使用缩略图
         //选区宽高比为1:1
         //$('#photo').imgAreaSelect({ aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //选区最大宽度200，最大高度150
         //$('#photo').imgAreaSelect({ maxWidth: 200, maxHeight: 150, handles: true, fadeSpeed: 200, onSelectChange: preview });

         //选区的起点和终点初始坐标
         //$('#photo').imgAreaSelect({ x1: 116, y1: 77, x2: 276, y2: 237, aspectRatio: '1:1', handles: true, fadeSpeed: 200, onSelectChange: preview });

         //任意尺寸的选区
         $('#photo').imgAreaSelect({ handles: true, fadeSpeed: 200, onSelectChange: preview });

         //缩略图的图片
         $("#preview img").attr("src",$("#photo").attr("src"));

     });
 </script>
 </head>

 <body>

     <div id="container">

         <!-- 原图 -->
         <div>
             <img id="photo" src="data:images/pic3.jpg"/>
         </div>

         <!-- 选区预览图 -->
         <div id="preview" style="display:none; overflow: hidden;">
             <img style="position: relative;">
         </div>

         <!-- 信息 -->
         <table style="margin-top: 1em;">
           <thead>
             <tr>
               <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                 坐标
               </th>
               <th colspan="2" style="font-size: 110%; font-weight: bold; text-align: left; padding-left: 0.1em;">
                 尺寸
               </th>
             </tr>
           </thead>
           <tbody>
             <tr>
               <td style="width: 10%;"><b>X<sub>1</sub>:</b></td>
                   <td style="width: 30%;"><input type="text" id="x1" value="-"></td>
                   <td style="width: 20%;"><b>Width:</b></td>
                 <td><input type="text" value="-" id="w"></td>
             </tr>
             <tr>
               <td><b>Y<sub>1</sub>:</b></td>
               <td><input type="text" id="y1" value="-"></td>
               <td><b>Height:</b></td>
               <td><input type="text" id="h" value="-"></td>
             </tr>
             <tr>
               <td><b>X<sub>2</sub>:</b></td>
               <td><input type="text" id="x2" value="-"></td>
               <td></td>
               <td></td>
             </tr>
             <tr>
               <td><b>Y<sub>2</sub>:</b></td>
               <td><input type="text" id="y2" value="-"></td>
               <td></td>
               <td></td>
             </tr>
           </tbody>
         </table>

     </div>

 </body>
 </html>

此插件只是用 jQuery 获取到了选区的各点坐标，要真正实现剪裁功能要把坐标值传给 PHP 文件进行图片剪裁处理。

附：demo 下载地址。

其他关于此插件的教程可以点击：http://www.cnblogs.com/mizzle/archive/2011/10/13/2209891.html

基于此插件的模块还可见：主页：PHP & jQuery image upload and crop，demo 自带上传、剪裁和保存功能。