做過 PHP GD 庫的圖片處理就會知道,裁剪的第一步永遠是「決定要保留哪個矩形區域」。這個介面要做的就是那個前置作業:在圖片上放一個半透明的選取框,使用者可以拖著它移動,也可以拖八個控制點改變大小;右側同步顯示裁剪結果的預覽,最後把座標與尺寸交給後端去裁。
成品由兩欄組成:左邊是原圖加上選取框,右邊是即時預覽。
<style type="text/css">
* { padding: 0; margin: 0; }
ul { list-style-type: none; overflow: hidden; zoom: 1; width: 1000px; margin: 30px auto; }
li { float: left; width: 500px; }
#container {
width: 480px; height: 480px;
margin: 0 auto;
border: 1px solid #999;
position: relative;
background: url(xx.jpg);
}
#container .block {
height: 100px; width: 100px;
border: 1px solid #000000;
position: absolute;
left: 50px; top: 50px;
background: #fff;
filter: alpha(opacity=30); /* 舊 IE */
opacity: 0.3;
cursor: move;
}
.rRightDown, .rLeftDown, .rLeftUp, .rRightUp,
.rRight, .rLeft, .rUp, .rDown {
position: absolute;
background: #f00;
width: 6px; height: 6px;
z-index: 5;
font-size: 0;
}
.rLeftDown, .rRightUp { cursor: ne-resize; }
.rRightDown, .rLeftUp { cursor: nw-resize; }
.rRight, .rLeft { cursor: e-resize; }
.rUp, .rDown { cursor: n-resize; }
.rRightDown { bottom: -3px; right: -3px; }
.rLeftDown { bottom: -3px; left: -3px; }
.rRightUp { top: -3px; right: -3px; }
.rLeftUp { top: -3px; left: -3px; }
.rRight { right: -3px; top: 50%; }
.rLeft { left: -3px; top: 50%; }
.rUp { top: -3px; left: 50%; }
.rDown { bottom: -3px; left: 50%; }
#imgC {
border: 1px solid #CCC;
width: 0; height: 0;
margin: 0 auto;
background: url(xx.jpg);
}
</style>
幾個細節:#container 必須是 position: relative,選取框才能以它為定位基準。八個控制點用 -3px 的負偏移讓紅色小方塊一半卡在框外,視覺上更清楚;cursor 依方向分別設為 move/ne-resize/nw-resize/e-resize/n-resize,讓使用者知道可以往哪個方向拉。預覽區 #imgC 用同一張背景圖,靠改變 background-position 來呈現裁剪效果——這是個很聰明的技巧,不必真的產生第二張圖。
<ul>
<li><div id="container"></div></li>
<li><div id="imgC"></div></li>
</ul>
<script type="text/javascript" src="jquery.js"></script>
(function () {
var dBody = document.body,
dDoc = document.documentElement;
var clip = function (options) {
this.init.call(this, options);
};
clip.prototype = {
options: {
moveCallBack: function () {},
className: "block"
},
init: function (options) {
$.extend(this, this.options, options || {});
if (!this.container || !this.imgC) { return; }
this.container = $(this.container);
var self = this;
// 動態產生選取框與八個控制點
this.block = $('<div class="' + this.className + '">
<div action="rightDown" class="rRightDown"></div>
<div action="leftDown" class="rLeftDown"></div>
<div action="rightUp" class="rRightUp"></div>
<div action="leftUp" class="rLeftUp"></div>
<div action="right" class="rRight"></div>
<div action="left" class="rLeft"></div>
<div action="up" class="rUp"></div>
<div action="down" class="rDown"></div>
</div>')
.bind("mousedown.r", function (e) { self.start(e); })
.appendTo(this.container[0]);
this.setImg();
},
// 依選取框的位置與大小更新預覽
setImg: function () {
var block = this.block;
this.imgC.css({
height: block.height(),
width: block.width(),
"background-position": "-" + block.css("left") + " -" + block.css("top")
});
},
start: function (e) {
var $elem = $(e.target),
block = this.block,
self = this,
move = false,
container = this.container,
action = $elem.attr("action");
// 每次都重新計算:基本 DOM 結構改變或瀏覽器縮放都會讓這些值變化
this.offset = $.extend(
{ height: container.height(), width: container.width() },
container.offset()
);
this.blockOriginal = {
height: block.height(),
width: block.width(),
left: parseInt(block.css("left")),
top: parseInt(block.css("top"))
};
if (action) {
this.fun = this[action]; // 命中某個控制點 → 縮放
} else {
this.x = e.clientX - this.offset.left - this.blockOriginal.left;
this.y = e.clientY - this.offset.top - this.blockOriginal.top;
move = true; // 沒命中控制點 → 移動
}
$(document)
.bind("mousemove.r", function (e) { self.move(e, move); })
.bind("mouseup.r", function () { self.end(); });
},
end: function () {
$(document).unbind("mousemove.r").unbind("mouseup.r");
},
move: function (e, isMove) {
// 消除拖曳時瀏覽器原生的文字選取
window.getSelection
? window.getSelection().removeAllRanges()
: document.selection.empty();
var block = this.block;
if (isMove) {
var left = Math.max(0, e.clientX - this.offset.left - this.x);
left = Math.min(left, this.offset.width - this.blockOriginal.width);
var top = Math.max(0, e.clientY - this.offset.top - this.y);
top = Math.min(top, this.offset.height - this.blockOriginal.height);
block.css({ left: left, top: top });
} else {
block.css(this.fun(e));
}
this.setImg();
this.moveCallBack();
},
down: function (e) {
var blockOriginal = this.blockOriginal,
sTop = Math.max(dBody.scrollTop, dDoc.scrollTop), // 有垂直捲軸時要計入
offset = this.offset;
if (e.clientY - offset.top >= blockOriginal.top - sTop) {
var height = Math.min(offset.height - blockOriginal.top,
e.clientY - offset.top - blockOriginal.top + sTop),
top = blockOriginal.top;
} else {
var height = Math.min(offset.top + blockOriginal.top - e.clientY - sTop,
blockOriginal.top),
top = Math.max(e.clientY - offset.top + sTop, 0);
}
return { height: height, top: top };
},
up: function (e) {
var blockOriginal = this.blockOriginal,
sTop = Math.max(dBody.scrollTop, dDoc.scrollTop),
offset = this.offset;
if (e.clientY - offset.top - blockOriginal.height <= blockOriginal.top - sTop) {
var top = Math.max(e.clientY - offset.top + sTop, 0),
maxHeight = blockOriginal.top + blockOriginal.height,
height = Math.min(maxHeight,
blockOriginal.top + blockOriginal.height - (e.clientY - offset.top) - sTop);
} else {
var height = Math.min(
e.clientY - offset.top - blockOriginal.top - blockOriginal.height + sTop,
offset.height - blockOriginal.top - blockOriginal.height),
top = blockOriginal.top + blockOriginal.height;
}
return { height: height, top: top };
},
left: function (e) {
var blockOriginal = this.blockOriginal,
offset = this.offset;
if (e.clientX - offset.left - blockOriginal.width - blockOriginal.left <= 0) {
var left = Math.max(e.clientX - offset.left, 0),
width = Math.min(blockOriginal.left + blockOriginal.width,
blockOriginal.left + blockOriginal.width - (e.clientX - offset.left));
} else {
var width = Math.min(e.clientX - offset.left - blockOriginal.left - blockOriginal.width,
offset.width - blockOriginal.left - blockOriginal.width),
left = blockOriginal.left + blockOriginal.width;
}
return { left: left, width: width };
},
right: function (e) {
var blockOriginal = this.blockOriginal,
offset = this.offset;
if (e.clientX - offset.left >= blockOriginal.left) {
var width = Math.min(offset.width - blockOriginal.left,
e.clientX - offset.left - blockOriginal.left),
left = blockOriginal.left;
} else {
var width = Math.min(offset.left + blockOriginal.left - e.clientX,
blockOriginal.left),
left = Math.max(e.clientX - offset.left, 0);
}
return { left: left, width: width };
},
// 四角 = 兩個方向的組合
rightDown: function (e) { return $.extend(this.right(e), this.down(e)); },
leftDown: function (e) { return $.extend(this.left(e), this.down(e)); },
rightUp: function (e) { return $.extend(this.right(e), this.up(e)); },
leftUp: function (e) { return $.extend(this.left(e), this.up(e)); },
// 對外公開:取得目前的裁剪座標
getValue: function () {
var block = this.block;
return {
left: parseInt(block.css("left")),
top: parseInt(block.css("top")),
width: block.width(),
height: block.height()
};
}
};
// 註冊成 jQuery 外掛
$.fn.clip = function (options) {
options.container = this;
return new clip(options);
};
})();
$("#container").clip({ imgC: $("#imgC") });
用原型而非每次 new 一個物件。方法都掛在 clip.prototype 上,實例只存狀態,記憶體用量小。最後再包成 $.fn.clip,就能用 $("#container").clip({...}) 這種 jQuery 風格的語法呼叫,並回傳實例讓外部取得 getValue() 的結果。
用 action 屬性做分派。八個控制點各自帶一個 action 屬性,start 裡讀出來後直接 this[action] 取得對應方法,省掉一整串 if-else。而四角的做法特別漂亮——rightDown 就是 $.extend(this.right(e), this.down(e)),把水平與垂直的計算結果合併,不必重複寫邊界判斷。
每次 mousedown 都重算 offset。註解說明了原因:DOM 結構改變、視窗縮放、圖片載入完成都會讓位置變化,用快取的值會出錯。這是實務上很值得記住的教訓。
用命名空間的 bind。bind("mousemove.r", ...) 裡的 .r 是事件命名空間,之後 unbind("mousemove.r") 就能只移除自己綁的那個,不會誤刪同事件的其他監聽器。
使用者拖好之後,取出座標送給伺服器:
var rect = $("#container").clip({ imgC: $("#imgC") }).getValue();
// { left: 50, top: 50, width: 200, height: 150 }
$.post("crop.aspx", rect, function (newUrl) {
$("#result").attr("src", newUrl);
});
伺服器端再用 GD 或 ImageMagick 依這四個數值裁切存檔即可。
沒有固定比例鎖定。身分證、頭像這類用途通常需要固定長寬比,可以在 move 裡對寬高做比例換算。
沒有最小尺寸限制。使用者可以把框拖到 0×0,送出後裁出一張空圖。加一個 MIN_SIZE 常數做下限即可。
沒有觸控支援。只綁了 mouse 事件,在平板或手機上完全不能用。需要額外處理 touchstart/touchmove/touchend,或改用 Pointer Events 統一處理。
座標是 CSS 像素,不是原圖像素。如果圖片被縮放顯示(例如 4000px 的照片縮成 480px 顯示),取得的座標必須乘上縮放比例才是原圖的實際位置。這一點很容易漏,導致裁出來的位置偏掉。
今天有現成方案。cropperjs、Jimp、Croppie 都是成熟且持續維護的選擇,支援觸控、觸控板縮放、旋轉、固定比例與行動裝置。除非有特殊需求,直接用它們會比自行維護這三百行程式碼划算得多。不過把這份實作讀懂,你會更清楚那些函式庫背後在做什麼——本質上就是座標計算、邊界夾住、以及即時預覽的同步這三件事。