jQuery Jcrop API參數說明(中文版)

Jcrop是一個jQuery圖片裁剪插件,它能爲你的WEB應用程序快速簡單地提供圖片裁剪的功能。特點如下:

  • 對所有圖片均unobtrusively(無侵入的,保持DOM簡潔)
  • 支持寬高比例鎖定
  • 支持 minSize/maxSize設置
  • 支持改變選區或移 動選區時的回調(Callback)
  • 支持用鍵盤微調選區
  • 通過API創建互動,比如動畫效果
  • 支持CSS樣式

版本及Demo

options 參數說明(可選)

參數名 默認值 參數說明
allowSelect true 允許新選框
allowMove true 允許選框移動
allowResize true 允許選框縮放
trackDocument true  
baseClass "jcrop" 基礎樣式名前綴。說明:class="jcrop-holder",更改的只是其中的 jcrop。
addClass null 添加樣式。假設class名爲 "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(){} 取消選框時的事件

使用方法

載入CSS文件

<link rel="stylesheet" href="css/jquery.Jcrop.css">

載入JavaScript文件

<script src="js/jquery.js"></script>  
<script src="js/jquery.Jcrop.js"></script> 

給圖像標籤加上ID

<img id="element_id" src="pic.jpg">

調用Jcrop

$("#element_id").Jcrop();

API方法說明

方法 方法的使用說明
setImage(string) 設定(或改變)圖像。例:jcrop_api.setImage("newpic.jpg")
setOptions(object) 設定(或改變)參數,格式與初始化設置參數一樣
setSelect(array) 創建選框,參數格式爲:[x,y,x2,y2]
animateTo(array) 用動畫效果創建選框,參數格式爲:[x,y,x2,y2]
release() 取消選框
disable() 禁用 Jcrop。說明:已有選框不會被清除。
enable() 啓用 Jcrop
destroy() 移除 Jcrop
tellSelect() 獲取選框的值(實際尺寸)。例子:console.log(jcrop_api.tellSelect())
tellScaled() 獲取選框的值(界面尺寸)。例子:console.log(jcrop_api.tellScaled())
getBounds() 獲取圖片實際尺寸,格式爲:[w,h]
getWidgetSize() 獲取圖片顯示尺寸,格式爲:[w,h]
getScaleFactor() 獲取圖片縮放的比例,格式爲:[w,h]
發佈了48 篇原創文章 · 獲贊 96 · 訪問量 57萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章