<canvas> 提供了一整套以腳本繪圖的 API,能畫圖形、處理影像,甚至做簡單的動畫與小遊戲。本文用它實作一個相當完整的圖片裁剪元件:可以在圖上拖曳選取框、拖動四個角縮放範圍、還能輸出裁剪後的 Base64 影像,同時相容觸屏操作。
<canvas> 只有 width 與 height 兩個屬性,用來設定畫布的寬高。若沒有透過標籤屬性或 JS 指定,預設尺寸是 300 × 150。
<canvas id="imagePreview" width="800" height="500"></canvas>
取得繪圖環境的方式是 canvas.getContext("2d"),之後所有繪製指令都透過這個 context 物件下達。
這個元件可以拆成四個關注點,各自獨立、職責清楚:
toDataURL() 轉成影像資料。function Selection(x, y, w, h) {
this.x = x; // 初始位置
this.y = y;
this.w = w; // 初始尺寸
this.h = h;
this.px = x; // 拖曳計算用的輔助座標
this.py = y;
this.csize = 4; // 控制點半徑
this.csizeh = 6; // hover 時放大的半徑
this.bHow = [false, false, false, false]; // 四角 hover 狀態
this.iCSize = [this.csize, this.csize, this.csize, this.csize];
this.bDrag = [false, false, false, false]; // 四角拖曳狀態
this.bDragAll = false; // 是否正在拖曳整個選取框
}
整個場景每一幀都重畫一次,順序是:清空畫布 → 畫原圖 → 鋪上半透明黑遮罩 → 畫選取框(框內區域重新畫一次原圖,形成「提亮」效果)→ 畫四角控制塊。
Selection.prototype.draw = function () {
ctx.strokeStyle = '#666';
ctx.lineWidth = 2;
ctx.strokeRect(this.x, this.y, this.w, this.h);
// 把選取區域的原圖重畫一次,達到「挖洞提亮」的視覺
if (this.w > 0 && this.h > 0) {
ctx.drawImage(image, this.x, this.y, this.w, this.h,
this.x, this.y, this.w, this.h);
}
// 畫四個縮放控制塊
ctx.fillStyle = '#999';
ctx.fillRect(this.x - this.iCSize[0], this.y - this.iCSize[0],
this.iCSize[0] * 2, this.iCSize[0] * 2);
ctx.fillRect(this.x + this.w - this.iCSize[1], this.y - this.iCSize[1],
this.iCSize[1] * 2, this.iCSize[1] * 2);
ctx.fillRect(this.x + this.w - this.iCSize[2], this.y + this.h - this.iCSize[2],
this.iCSize[2] * 2, this.iCSize[2] * 2);
ctx.fillRect(this.x - this.iCSize[3], this.y + this.h - this.iCSize[3],
this.iCSize[3] * 2, this.iCSize[3] * 2);
};
var drawScene = function () {
ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);
ctx.drawImage(image, 0, 0, ctx.canvas.width, ctx.canvas.height);
// 半透明遮罩
ctx.fillStyle = 'rgba(0, 0, 0, 0.5)';
ctx.fillRect(0, 0, ctx.canvas.width, ctx.canvas.height);
selectObj.draw();
canvas.mousedown(canvasMouseDown);
canvas.on("touchstart", canvasMouseDown);
};
canvasMouseMove 是整個元件最複雜的一段,它同時負責三件事:判斷游標是否落在四個控制點上(切換游標為 pointer)、判斷是否在選取框內(切換為 move)、以及在拖曳時重新計算選取框的座標與尺寸。
function canvasMouseMove(e) {
var canvasOffset = canvas.offset();
var pageX = e.pageX || event.targetTouches[0].pageX;
var pageY = e.pageY || event.targetTouches[0].pageY;
iMouseX = Math.floor(pageX - canvasOffset.left);
iMouseY = Math.floor(pageY - canvasOffset.top);
canvas.css("cursor", "default");
// 拖曳整個選取框,並夾在畫布範圍內
if (selectObj.bDragAll) {
canvas.css("cursor", "move");
canvas.data("drag", true);
var cx = iMouseX - selectObj.px;
cx = cx < 0 ? 0 : cx;
mx = ctx.canvas.width - selectObj.w;
cx = cx > mx ? mx : cx;
selectObj.x = cx;
var cy = iMouseY - selectObj.py;
cy = cy < 0 ? 0 : cy;
my = ctx.canvas.height - selectObj.h;
cy = cy > my ? my : cy;
selectObj.y = cy;
}
for (var i = 0; i < 4; i++) {
selectObj.bHow[i] = false;
selectObj.iCSize[i] = selectObj.csize;
}
// 四角的 hover 命中判定(以左上角為例)
if (iMouseX > selectObj.x - selectObj.csizeh && iMouseX < selectObj.x + selectObj.csizeh &&
iMouseY > selectObj.y - selectObj.csizeh && iMouseY < selectObj.y + selectObj.csizeh) {
canvas.css("cursor", "pointer");
selectObj.bHow[0] = true;
selectObj.iCSize[0] = selectObj.csizeh; // hover 時控制塊變大
}
// … 其餘三角判定邏輯相同,只是基準座標換成 x+w / y+h
// 拖曳縮放:依被拖動的角,重新算出 iFX / iFY / iFW / iFH
if (selectObj.bDrag[0]) {
iFX = iMouseX - selectObj.px;
iFY = iMouseY - selectObj.py;
iFW = selectObj.w + selectObj.x - iFX;
iFH = selectObj.h + selectObj.y - iFY;
canvas.data("drag", true);
}
// … 其餘三角同理
// 尺寸下限保護:避免選取框被拖成負數或過小
if (iFW > selectObj.csizeh * 2 && iFH > selectObj.csizeh * 2) {
selectObj.w = iFW;
selectObj.h = iFH;
selectObj.x = iFX;
selectObj.y = iFY;
}
drawScene();
}
這裡有兩個值得注意的防禦性設計:一是每次拖曳後都用三元運算式把座標夾在 0 到「畫布尺寸減去選取框尺寸」之間,避免選取框被拖出畫面;二是用 csizeh * 2 作為尺寸下限,防止寬高變成負值導致後續繪製出錯。
var StopSelect = function (e) {
var canvasOffset = $(canvas).offset();
var pageX = e.pageX || event.targetTouches[0].pageX;
var pageY = e.pageY || event.targetTouches[0].pageY;
iMouseX = Math.floor(pageX - canvasOffset.left);
iMouseY = Math.floor(pageY - canvasOffset.top);
selectObj.px = iMouseX - selectObj.x;
selectObj.py = iMouseY - selectObj.y;
// 依按下的控制點,調整拖曳基準偏移
if (selectObj.bHow[1]) {
selectObj.px = iMouseX - selectObj.x - selectObj.w;
selectObj.py = iMouseY - selectObj.y;
}
// … 四角各自對應不同的基準計算
// 若按在框內側(避開四角),進入「整體拖曳」模式
if (iMouseX > selectObj.x + selectObj.csizeh &&
iMouseX < selectObj.x + selectObj.w - selectObj.csizeh &&
iMouseY > selectObj.y + selectObj.csizeh &&
iMouseY < selectObj.y + selectObj.h - selectObj.csizeh) {
selectObj.bDragAll = true;
}
for (var i = 0; i < 4; i++) {
if (selectObj.bHow[i]) { selectObj.bDrag[i] = true; }
}
};
這一此方法用得很巧:建立一張全新的臨時 canvas,尺寸設為選取框大小,再把原圖的選取區域對位畫上去,最後用 toDataURL() 轉成 PNG Base64 字串。
this.getImageData = function (previewID) {
var tmpCanvas = $("<canvas></canvas>")[0];
var tmpCtx = tmpCanvas.getContext("2d");
if (tmpCanvas && selectObj) {
tmpCanvas.width = selectObj.w;
tmpCanvas.height = selectObj.h;
// 九參數版本:來源圖的裁剪矩形 → 目標畫布的整個區域
tmpCtx.drawImage(image,
selectObj.x, selectObj.y, selectObj.w, selectObj.h,
0, 0, selectObj.w, selectObj.h);
if (document.getElementById(previewID)) {
document.getElementById(previewID).src = tmpCanvas.toDataURL();
document.getElementById(previewID).style.border = "1px solid #ccc";
}
return tmpCanvas.toDataURL();
}
};
drawImage 的九參數形式是裁剪的關鍵:(image, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight)。前四個參數定義「從來源圖的哪個矩形取資料」,後四個定義「畫到目標的哪個位置、多大」。只要理解這兩組矩形的對應關係,各種裁剪、縮圖、拼圖需求都能迎刃而解。
上傳圖片往往尺寸過大,實務上會先在客戶端等比縮 ourselves 再處理。這個函式在給定的最大寬高內做等比縮放,並保留「不放大只縮小」的行為:
function autoResizeImage(maxWidth, maxHeight, objImg) {
var img = new Image();
img.src = objImg.src;
var w = objImg.width, h = objImg.height;
if (w < maxWidth && h < maxHeight) { return; } // 比限制小就不處理
var wRatio = maxWidth / w;
var hRatio = maxHeight / h;
var ratio = Math.min(wRatio, hRatio); // 取較小的比例,確保兩邊都不溢出
if (ratio < 1) {
w = w * ratio;
h = h * ratio;
}
objImg.width = w;
objImg.height = h;
}
原範例用了長串 if-else 分支處理各種邊界組合,但其實「取兩個比例中較小者」這一句就足以涵蓋絕大多數情況,程式碼可讀性也好得多。
元件初始化時傳入 canvas 的 id、圖片來源,以及選取框的初始位置與大小(不傳則預設置中):
var cropper = new ImageCrop('imagePreview', 'photo.jpg', 100, 80, 300, 200);
// 稍後取出裁剪結果
var dataUrl = cropper.getImageData('previewImg');
這個元件同時綁定了 mousedown/mousemove/mouseup 與 touchstart/touchmove/touchend,因此在手機與桌機上都能操作。若想進一步優化,可以考慮改用 Pointer Events 統一兩套事件,並在拖曳時搭配 requestAnimationFrame 而非每次移動都重繪,能明顯降低低端裝置上的負擔。