DIV CSS 佈局教程網

JavaScript 圖片裁剪:可拖曳可縮放的選取框實作
編輯:JavaScript綜合知識     

功能目標

做過 PHP GD 庫的圖片處理就會知道,裁剪的第一步永遠是「決定要保留哪個矩形區域」。這個介面要做的就是那個前置作業:在圖片上放一個半透明的選取框,使用者可以拖著它移動,也可以拖八個控制點改變大小;右側同步顯示裁剪結果的預覽,最後把座標與尺寸交給後端去裁。

成品由兩欄組成:左邊是原圖加上選取框,右邊是即時預覽。

CSS:容器、選取框與八個控制點

<style type="text/css">
* { padding: 0; margin: 0; }
ul { list-style-type: none; overflow: hidden; zoom: 1; width: 1000px; margin: 30px auto; }
li { float: left; width: 500px; }

#container {
    width: 480px; height: 480px;
    margin: 0 auto;
    border: 1px solid #999;
    position: relative;
    background: url(xx.jpg);
}

#container .block {
    height: 100px; width: 100px;
    border: 1px solid #000000;
    position: absolute;
    left: 50px; top: 50px;
    background: #fff;
    filter: alpha(opacity=30);      /* 舊 IE */
    opacity: 0.3;
    cursor: move;
}

.rRightDown, .rLeftDown, .rLeftUp, .rRightUp,
.rRight, .rLeft, .rUp, .rDown {
    position: absolute;
    background: #f00;
    width: 6px; height: 6px;
    z-index: 5;
    font-size: 0;
}
.rLeftDown, .rRightUp { cursor: ne-resize; }
.rRightDown, .rLeftUp { cursor: nw-resize; }
.rRight, .rLeft      { cursor: e-resize; }
.rUp, .rDown         { cursor: n-resize; }

.rRightDown { bottom: -3px; right: -3px; }
.rLeftDown  { bottom: -3px; left: -3px; }
.rRightUp   { top: -3px; right: -3px; }
.rLeftUp    { top: -3px; left: -3px; }
.rRight { right: -3px; top: 50%; }
.rLeft  { left: -3px;  top: 50%; }
.rUp    { top: -3px;    left: 50%; }
.rDown  { bottom: -3px; left: 50%; }

#imgC {
    border: 1px solid #CCC;
    width: 0; height: 0;
    margin: 0 auto;
    background: url(xx.jpg);
}
</style>

幾個細節:#container 必須是 position: relative,選取框才能以它為定位基準。八個控制點用 -3px 的負偏移讓紅色小方塊一半卡在框外,視覺上更清楚;cursor 依方向分別設為 move/ne-resize/nw-resize/e-resize/n-resize,讓使用者知道可以往哪個方向拉。預覽區 #imgC 用同一張背景圖,靠改變 background-position 來呈現裁剪效果——這是個很聰明的技巧,不必真的產生第二張圖。

HTML 結構

<ul>
<li><div id="container"></div></li>
<li><div id="imgC"></div></li>
</ul>

<script type="text/javascript" src="jquery.js"></script>

JavaScript:用原型建構一個可 reuse 的元件

(function () {
    var dBody = document.body,
        dDoc  = document.documentElement;

    var clip = function (options) {
        this.init.call(this, options);
    };

    clip.prototype = {
        options: {
            moveCallBack: function () {},
            className: "block"
        },

        init: function (options) {
            $.extend(this, this.options, options || {});
            if (!this.container || !this.imgC) { return; }

            this.container = $(this.container);
            var self = this;

            // 動態產生選取框與八個控制點
            this.block = $('<div class="' + this.className + '">
<div action="rightDown" class="rRightDown"></div>
<div action="leftDown"  class="rLeftDown"></div>
<div action="rightUp"   class="rRightUp"></div>
<div action="leftUp"    class="rLeftUp"></div>
<div action="right"     class="rRight"></div>
<div action="left"      class="rLeft"></div>
<div action="up"        class="rUp"></div>
<div action="down"      class="rDown"></div>
</div>')
                .bind("mousedown.r", function (e) { self.start(e); })
                .appendTo(this.container[0]);

            this.setImg();
        },

        // 依選取框的位置與大小更新預覽
        setImg: function () {
            var block = this.block;
            this.imgC.css({
                height: block.height(),
                width:  block.width(),
                "background-position": "-" + block.css("left") + " -" + block.css("top")
            });
        },

        start: function (e) {
            var $elem = $(e.target),
                block = this.block,
                self  = this,
                move  = false,
                container = this.container,
                action = $elem.attr("action");

            // 每次都重新計算:基本 DOM 結構改變或瀏覽器縮放都會讓這些值變化
            this.offset = $.extend(
                { height: container.height(), width: container.width() },
                container.offset()
            );
            this.blockOriginal = {
                height: block.height(),
                width:  block.width(),
                left:   parseInt(block.css("left")),
                top:    parseInt(block.css("top"))
            };

            if (action) {
                this.fun = this[action];        // 命中某個控制點 → 縮放
            } else {
                this.x = e.clientX - this.offset.left - this.blockOriginal.left;
                this.y = e.clientY - this.offset.top  - this.blockOriginal.top;
                move = true;                    // 沒命中控制點 → 移動
            }

            $(document)
                .bind("mousemove.r", function (e) { self.move(e, move); })
                .bind("mouseup.r",   function ()  { self.end(); });
        },

        end: function () {
            $(document).unbind("mousemove.r").unbind("mouseup.r");
        },

        move: function (e, isMove) {
            // 消除拖曳時瀏覽器原生的文字選取
            window.getSelection
                ? window.getSelection().removeAllRanges()
                : document.selection.empty();

            var block = this.block;
            if (isMove) {
                var left = Math.max(0, e.clientX - this.offset.left - this.x);
                left = Math.min(left, this.offset.width - this.blockOriginal.width);
                var top = Math.max(0, e.clientY - this.offset.top - this.y);
                top = Math.min(top, this.offset.height - this.blockOriginal.height);
                block.css({ left: left, top: top });
            } else {
                block.css(this.fun(e));
            }
            this.setImg();
            this.moveCallBack();
        },

        down: function (e) {
            var blockOriginal = this.blockOriginal,
                sTop = Math.max(dBody.scrollTop, dDoc.scrollTop),  // 有垂直捲軸時要計入
                offset = this.offset;

            if (e.clientY - offset.top >= blockOriginal.top - sTop) {
                var height = Math.min(offset.height - blockOriginal.top,
                                      e.clientY - offset.top - blockOriginal.top + sTop),
                    top = blockOriginal.top;
            } else {
                var height = Math.min(offset.top + blockOriginal.top - e.clientY - sTop,
                                      blockOriginal.top),
                    top = Math.max(e.clientY - offset.top + sTop, 0);
            }
            return { height: height, top: top };
        },

        up: function (e) {
            var blockOriginal = this.blockOriginal,
                sTop = Math.max(dBody.scrollTop, dDoc.scrollTop),
                offset = this.offset;

            if (e.clientY - offset.top - blockOriginal.height <= blockOriginal.top - sTop) {
                var top = Math.max(e.clientY - offset.top + sTop, 0),
                    maxHeight = blockOriginal.top + blockOriginal.height,
                    height = Math.min(maxHeight,
                        blockOriginal.top + blockOriginal.height - (e.clientY - offset.top) - sTop);
            } else {
                var height = Math.min(
                    e.clientY - offset.top - blockOriginal.top - blockOriginal.height + sTop,
                    offset.height - blockOriginal.top - blockOriginal.height),
                    top = blockOriginal.top + blockOriginal.height;
            }
            return { height: height, top: top };
        },

        left: function (e) {
            var blockOriginal = this.blockOriginal,
                offset = this.offset;

            if (e.clientX - offset.left - blockOriginal.width - blockOriginal.left <= 0) {
                var left = Math.max(e.clientX - offset.left, 0),
                    width = Math.min(blockOriginal.left + blockOriginal.width,
                        blockOriginal.left + blockOriginal.width - (e.clientX - offset.left));
            } else {
                var width = Math.min(e.clientX - offset.left - blockOriginal.left - blockOriginal.width,
                    offset.width - blockOriginal.left - blockOriginal.width),
                    left = blockOriginal.left + blockOriginal.width;
            }
            return { left: left, width: width };
        },

        right: function (e) {
            var blockOriginal = this.blockOriginal,
                offset = this.offset;

            if (e.clientX - offset.left >= blockOriginal.left) {
                var width = Math.min(offset.width - blockOriginal.left,
                    e.clientX - offset.left - blockOriginal.left),
                    left = blockOriginal.left;
            } else {
                var width = Math.min(offset.left + blockOriginal.left - e.clientX,
                    blockOriginal.left),
                    left = Math.max(e.clientX - offset.left, 0);
            }
            return { left: left, width: width };
        },

        // 四角 = 兩個方向的組合
        rightDown: function (e) { return $.extend(this.right(e), this.down(e)); },
        leftDown:  function (e) { return $.extend(this.left(e),  this.down(e)); },
        rightUp:   function (e) { return $.extend(this.right(e), this.up(e)); },
        leftUp:    function (e) { return $.extend(this.left(e),  this.up(e)); },

        // 對外公開:取得目前的裁剪座標
        getValue: function () {
            var block = this.block;
            return {
                left:   parseInt(block.css("left")),
                top:    parseInt(block.css("top")),
                width:  block.width(),
                height: block.height()
            };
        }
    };

    // 註冊成 jQuery 外掛
    $.fn.clip = function (options) {
        options.container = this;
        return new clip(options);
    };
})();

$("#container").clip({ imgC: $("#imgC") });

幾個設計手法值得學

用原型而非每次 new 一個物件。方法都掛在 clip.prototype 上,實例只存狀態,記憶體用量小。最後再包成 $.fn.clip,就能用 $("#container").clip({...}) 這種 jQuery 風格的語法呼叫,並回傳實例讓外部取得 getValue() 的結果。

用 action 屬性做分派。八個控制點各自帶一個 action 屬性,start 裡讀出來後直接 this[action] 取得對應方法,省掉一整串 if-else。而四角的做法特別漂亮——rightDown 就是 $.extend(this.right(e), this.down(e)),把水平與垂直的計算結果合併,不必重複寫邊界判斷。

每次 mousedown 都重算 offset。註解說明了原因:DOM 結構改變、視窗縮放、圖片載入完成都會讓位置變化,用快取的值會出錯。這是實務上很值得記住的教訓。

用命名空間的 bind。bind("mousemove.r", ...) 裡的 .r 是事件命名空間,之後 unbind("mousemove.r") 就能只移除自己綁的那個,不會誤刪同事件的其他監聽器。

接上後端

使用者拖好之後,取出座標送給伺服器:

var rect = $("#container").clip({ imgC: $("#imgC") }).getValue();
// { left: 50, top: 50, width: 200, height: 150 }

$.post("crop.aspx", rect, function (newUrl) {
    $("#result").attr("src", newUrl);
});

伺服器端再用 GD 或 ImageMagick 依這四個數值裁切存檔即可。

這個實作的限制

沒有固定比例鎖定。身分證、頭像這類用途通常需要固定長寬比,可以在 move 裡對寬高做比例換算。

沒有最小尺寸限制。使用者可以把框拖到 0×0,送出後裁出一張空圖。加一個 MIN_SIZE 常數做下限即可。

沒有觸控支援。只綁了 mouse 事件,在平板或手機上完全不能用。需要額外處理 touchstart/touchmove/touchend,或改用 Pointer Events 統一處理。

座標是 CSS 像素,不是原圖像素。如果圖片被縮放顯示(例如 4000px 的照片縮成 480px 顯示),取得的座標必須乘上縮放比例才是原圖的實際位置。這一點很容易漏,導致裁出來的位置偏掉。

今天有現成方案。cropperjs、Jimp、Croppie 都是成熟且持續維護的選擇,支援觸控、觸控板縮放、旋轉、固定比例與行動裝置。除非有特殊需求,直接用它們會比自行維護這三百行程式碼划算得多。不過把這份實作讀懂,你會更清楚那些函式庫背後在做什麼——本質上就是座標計算、邊界夾住、以及即時預覽的同步這三件事。

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