Jcrop 是基於 jQuery 的經典圖片裁剪插件,能讓用戶在頁面上拖拽選框直觀地指定裁剪區域。本文整理它的接入步驟、常用參數與 API 方法。
在 head 中依次引入樣式與腳本:
<link rel="stylesheet" href="css/jquery.Jcrop.css">
<script src="js/jquery.js"></script>
<script src="js/jquery.Jcrop.js"></script>
<script language="Javascript">
<!--
jQuery(function($){
// 定義變量保存 API 與圖片真實尺寸
var jcrop_api, boundx, boundy;
$('#cropbox').Jcrop({
minSize: [0,0],
maxSize:[0,0],
setSelect: [0,0,0,0],
boxWidth:800,
borderOpacity:0.3,
keySupport:false,
dragEdges:false,
allowSelect:false,
allowResize:false,
bgOpacity:0.2,
boundary:0,
addClass: 'jcrop-handle',
onSelect: updateCoords,
},
function(){
// 通過 API 取得圖片真實尺寸
var bounds = this.getBounds();
boundx = bounds[0];
boundy = bounds[1];
// 保存 API 實例
jcrop_api = this;
});
function updateCoords(c)
{
$('#x').val(c.x);
$('#y').val(c.y);
$('#w').val(c.w);
$('#h').val(c.h);
};
function checkCoords()
{
if (parseInt($('#w').val())) return true;
alert('請選擇裁剪區域');
return false;
};
});
-->
</script>
第二個參數位置上傳入的匿名函數是加載完成回調,在這裡拿到真實尺寸並保存 API 實例;onSelect 則在選框變化時把 x、y、w、h 寫入隱藏字段,便於表單提交。
<img id="cropbox" src="x.jpg">
id 必須與初始化選擇器一致。完成這三步,最基礎的裁剪交互就可以工作了;至於如何把坐標交給 PHP 等後端做真實裁剪,屬於後續的服務端圖像處理。
<thead>
<th width="140">名稱</th> <th width="120">默認值</th> <th>說明</th>
</thead>
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(){} — 取消選框時觸發
<thead>
<th width="140">名稱</th> <th>說明</th>
</thead>
setImage(string) — 設定或更換圖像,如 jcrop_api.setImage("newpic.jpg")
setOptions(object) — 設定或修改參數,格式與初始化時相同
setSelect(array) — 創建選框,參數格式為 [x, y, x2, y2]
animateTo(array) — 以動畫效果創建選框,參數格式同上
release() — 取消選框
disable() — 禁用 Jcrop,已有選框不會被清除
enable() — 重新啟用 Jcrop
destroy() — 移除 Jcrop
tellSelect() — 獲取選框的實際尺寸,如 console.log(jcrop_api.tellSelect())
tellScaled() — 獲取選框的界面顯示尺寸
getBounds() — 獲取圖片實際尺寸,格式為 [w, h]
getWidgetSize() — 獲取圖片顯示尺寸,格式為 [w, h]
getScaleFactor() — 獲取圖片縮放比例,格式為 [w, h]