DIV CSS 佈局教程網

用 JavaScript + Canvas 打造互動式圖片裁剪工具
編輯:關於JavaScript     

<canvas> 提供了一整套以腳本繪圖的 API,能畫圖形、處理影像,甚至做簡單的動畫與小遊戲。本文用它實作一個相當完整的圖片裁剪元件:可以在圖上拖曳選取框、拖動四個角縮放範圍、還能輸出裁剪後的 Base64 影像,同時相容觸屏操作。

一、先認識 canvas 的基本設定

<canvas> 只有 width 與 height 兩個屬性,用來設定畫布的寬高。若沒有透過標籤屬性或 JS 指定,預設尺寸是 300 × 150。

<canvas id="imagePreview" width="800" height="500"></canvas>

取得繪圖環境的方式是 canvas.getContext("2d"),之後所有繪製指令都透過這個 context 物件下達。

二、整體架構設計

這個元件可以拆成四個關注點,各自獨立、職責清楚:

  • 狀態(Selection):記錄選取框的 x、y、寬、高,以及拖曳狀態與四角控制點的 hover 狀態。
  • 繪製(drawScene / draw):重畫原圖、加上半透明遮罩、再畫出選取框與四角控制塊。
  • 互動(mouse / touch 事件):判斷目前游標落在框內、框外還是四個角上,切換游標樣式並更新狀態。
  • 輸出(getImageData):建立一張臨時 canvas,把選取區域畫上去,再用 toDataURL() 轉成影像資料。

三、狀態物件:Selection

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 而非每次移動都重繪,能明顯降低低端裝置上的負擔。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved