jQuery Jcrop 影象裁剪
阿新 • • 發佈：2019-02-11
Jcrop 是一個功能強大的 jQuery 影象裁剪外掛，結合後端程式（例如：PHP）可以快速的實現圖片裁剪的功能。
文件目錄- 使用方法
- 引數說明
- API 介面
- 相關資訊
使用方法
載入 CSS 檔案
<link rel="stylesheet" href="jquery.Jcrop.css">載入 JavaScript 檔案
<script src="jquery.js"></script>
<script src="jquery.Jcrop.js"></script>
給 IMG 標籤加上 ID
<img id="element_id" 呼叫 Jcrop
$('#element_id').Jcrop();引數說明
| 名稱 | 預設值 | 說明 |
|---|---|---|
| allowSelect | true | 允許新選框 |
| allowMove | true | 允許選框移動 |
| allowResize | true | 允許選框縮放 |
| trackDocument | true | 拖動選框時，允許超出影象以外的地方時繼續拖動。 |
| baseClass | 'jcrop' |
基礎樣式名字首。說明：class="jcrop-holder"，更改的只是其中的 jcrop。
例：假設值為 "test"，那麼樣式名會更改為 "test-holder" |
| addClass | null |
新增樣式。
例：假設值為 "test"，那麼會新增樣式到 |
| bgColor | 'black' | 背景顏色。顏色關鍵字、HEX、RGB 均可。 |
| bgOpacity | 0.6 | 背景透明度 |
| bgFade | false | 使用背景過渡效果 |
| borderOpacity | 0.4 | 選框邊框透明度 |
| handleOpacity | 0.5 | 縮放按鈕透明度 |
| handleSize | null | 縮放按鈕大小 |
| aspectRatio | 0 | 選框寬高比。說明：width/height |
| keySupport | true | 支援鍵盤控制。按鍵列表：上下左右（移動選框）、Esc（取消選框） |
| createHandles | ['n','s','e','w','nw','ne','se','sw'] | 設定邊角控制器 |
| createDragbars | ['n','s','e','w'] | 設定邊框控制器 |
| createBorders | ['n','s','e','w'] | 設定邊框 |
| drawBorders | true | 繪製邊框 |
| dragEdges | true | 允許拖動邊框 |
| fixedSupport | true | 支援 fixed，例如：IE6、iOS4 |
| touchSupport | null | 支援觸控事件 |
| shade | 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() {} | 選框選定時的事件 |
| onDblClick | function() {} | 在選框內雙擊時的事件 |
| onRelease | function() {} | 取消選框時的事件 |
API 介面
var jcropApi;
$('#element_id').Jcrop({
allowSelect: true,
baseClass: 'jcrop'
}, function() {
jcropApi = this;
});| 名稱 | 說明 |
|---|---|
| setImage(string, callback) | 設定（或改變）影象。例：jcropApi.setImage('newpic.jpg') |
| setOptions(object) | 設定（或改變）引數，格式與初始化設定引數一樣 |
| setSelect(array) | 建立選框，引數格式為：[x, y, x2, y2] |
| animateTo(array, callback) | 用動畫效果建立選框，引數格式為：[x, y, x2, y2] |
| release() | 取消選框 |
| disable() | 禁用 Jcrop。說明：已有選框不會被清除。 |
| enable() | 啟用 Jcrop |
| destroy() | 移除 Jcrop |
| tellSelect() | 獲取選框的值（實際尺寸）。例：console.log(jcropApi.tellSelect()) |
| tellScaled() | 獲取選框的值（介面尺寸）。例：console.log(jcropApi.tellScaled()) |
| getBounds() | 獲取圖片實際尺寸，格式為：[w, h] |
| getWidgetSize() | 獲取圖片顯示尺寸，格式為：[w, h] |
| getScaleFactor() | 獲取圖片縮放的比例，格式為：[w, h] |