Jcrop 是一款功能強大的 jQuery 圖片裁剪外掛。本文整理它的基本用法、常用參數與 API 方法,方便快速上手。
一、在 head 中引入相關 CSS 與 JS 檔:
<link rel="stylesheet" href="css/jquery.Jcrop.css">
<script src="js/jquery.js"></script>
<script src="js/jquery.Jcrop.js"></script>
二、在 head 中撰寫初始化與回呼處理:
<script language="Javascript">
jQuery(function($){
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(){
var bounds = this.getBounds();
boundx = bounds[0];
boundy = bounds[1];
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>
三、為圖片加上 id 以便識別:
<img id="cropbox" src="x.jpg">
如此一來,最簡單的裁剪效果就完成了。若要結合 PHP 等後端做動態處理,可再搭配伺服器端程式。
allowSelect(允許新選框)、allowMove(允許移動選框)、allowResize(允許縮放選框)、bgColor(背景顏色)、bgOpacity(背景透明度)、borderOpacity(邊框透明度)、aspectRatio(選框寬高比)、keySupport(鍵盤控制)、minSize/maxSize(選框最小/最大尺寸)、boxWidth/boxHeight(畫布尺寸)等,都是相當實用的設定。
事件部分則有 onChange(選框改變時)、onSelect(選框選定時)、onRelease(取消選框時)。
setImage() 設定或替換圖像;setOptions() 變更參數;setSelect() 建立選框;animateTo() 以動畫建立選框;release() 取消選框;disable()/enable() 啟停 Jcrop;destroy() 移除;tellSelect() 取得選框實際尺寸;tellScaled() 取得選框顯示尺寸;getBounds() 取得圖片實際尺寸;getWidgetSize() 取得顯示尺寸;getScaleFactor() 取得縮放比例。