DIV CSS 佈局教程網

Jcrop 使用指南:接入步驟、參數表與 API 速查
編輯:關於JavaScript     

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 等後端做真實裁剪,屬於後續的服務端圖像處理。

四、options 參數一覽

<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(){} — 取消選框時觸發

五、API 方法

<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]

六、實戰提醒

  • 坐標換算是重中之重。界面顯示尺寸與圖片真實尺寸往往不同,提交給後端的必須是按 getScaleFactor() 換算後的真實坐標,否則裁剪結果一定偏移。
  • 表單提交前做 checkCoords 之類的校驗,避免用戶未選區域就提交。
  • 固定比例裁剪(如頭像 1:1)設置 aspectRatio: 1,並配合 minSize 限制最小可用尺寸。
  • 移動端記得開 touchSupport,否則觸屏設備無法操作。
  • Jcrop 已多年未更新,新項目可評估 Cropper.js 等維護活躍的替代方案。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved