DIV CSS 佈局教程網

Jcrop 基本參數與 API 方法一覽
編輯:JavaScript綜合知識     

Jcrop 是一款功能強大的 jQuery 圖片裁剪外掛。本文整理它的基本用法、常用參數與 API 方法,方便快速上手。

基本使用方法

一、在 head 中引入相關 CSS 與 JS 檔:

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

二、在 head 中撰寫初始化與回呼處理:

<script language="Javascript">
jQuery(function($){
    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(){
        var bounds = this.getBounds();
        boundx = bounds[0];
        boundy = bounds[1];
        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>

三、為圖片加上 id 以便識別:

<img id="cropbox" src="x.jpg">

如此一來,最簡單的裁剪效果就完成了。若要結合 PHP 等後端做動態處理,可再搭配伺服器端程式。

常用 options 參數

allowSelect(允許新選框)、allowMove(允許移動選框)、allowResize(允許縮放選框)、bgColor(背景顏色)、bgOpacity(背景透明度)、borderOpacity(邊框透明度)、aspectRatio(選框寬高比)、keySupport(鍵盤控制)、minSize/maxSize(選框最小/最大尺寸)、boxWidth/boxHeight(畫布尺寸)等,都是相當實用的設定。

事件部分則有 onChange(選框改變時)、onSelect(選框選定時)、onRelease(取消選框時)。

常用 API 方法

setImage() 設定或替換圖像;setOptions() 變更參數;setSelect() 建立選框;animateTo() 以動畫建立選框;release() 取消選框;disable()/enable() 啟停 Jcrop;destroy() 移除;tellSelect() 取得選框實際尺寸;tellScaled() 取得選框顯示尺寸;getBounds() 取得圖片實際尺寸;getWidgetSize() 取得顯示尺寸;getScaleFactor() 取得縮放比例。

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