DIV CSS 佈局教程網

JavaScript 拖拉縮放:做出像 PS 一樣的等比選取框
編輯:關於JavaScript     

這個範例的野心比一般小特效大得多:用原生 JavaScript 做出一個可以八個方向拖曳縮放、能限制在容器內、可切換等比縮放與最小尺寸限制的元件,就像影像軟體裡的選取框。它幾乎把滑鼠事件處理的所有細節都涵蓋了。

整體架構

程式先準備了一組通用工具:$ 簡化元素取得、Class.create() 建立帶有 initialize 的類別、Extend() 合併設定物件、Bind() 與 BindAsEventListener() 綁定 this、CurrentStyle() 跨瀏覽器取樣式,以及 addEventHandler / removeEventHandler。接著以 Resize 類別封裝全部縮放邏輯。

工具函式

var isIE = (document.all) ? true : false;
var $ = function (id) {
  return "string" == typeof id ? document.getElementById(id) : id;
};
var Class = { create: function () {
  return function () { this.initialize.apply(this, arguments); };
} };
var Extend = function (destination, source) {
  for (var property in source) { destination[property] = source[property]; }
};
var Bind = function (object, fun) {
  return function () { return fun.apply(object, arguments); };
};
var BindAsEventListener = function (object, fun) {
  var args = Array.prototype.slice.call(arguments).slice(2);
  return function (event) {
    return fun.apply(object, [event || window.event].concat(args));
  };
};
var CurrentStyle = function (element) {
  return element.currentStyle || document.defaultView.getComputedStyle(element, null);
};
function addEventHandler(oTarget, sEventType, fnHandler) {
  if (oTarget.addEventListener)      oTarget.addEventListener(sEventType, fnHandler, false);
  else if (oTarget.attachEvent)      oTarget.attachEvent("on" + sEventType, fnHandler);
  else                               oTarget["on" + sEventType] = fnHandler;
}
function removeEventHandler(oTarget, sEventType, fnHandler) {
  if (oTarget.removeEventListener)   oTarget.removeEventListener(sEventType, fnHandler, false);
  else if (oTarget.detachEvent)      oTarget.detachEvent("on" + sEventType, fnHandler);
  else                               oTarget["on" + sEventType] = null;
}

Resize 類別的關鍵設計

起始狀態記錄。Start() 在 mousedown 時把當下的寬高與座標存進 _styleWidth、_styleHeight、_styleLeft、_styleTop,並記下四條邊的滑鼠基準點,後續所有計算都以這些基準為準。

方向分派。Set(resize, side) 依 side 字串(up / down / left / right 與四個斜角)挑選對應的處理函式,再綁到該手柄的 mousedown 上。

轉向處理。拖曳時難免會把邊界拉過頭,此時縮放方向要自動反轉。程式用 TurnRight / TurnLeft / TurnUp / TurnDown 在寬或高歸零時切換執行函式,並交換基準點,這是最容易忽略卻最影響手感的部分。

等比縮放。開啟 Scale 後,每次改動寬或高,都透過 RepairScaleWidth() / RepairScaleHeight() 依 Ratio 反算另一邊,並以中心點 _scaleLeft / _scaleTop 保持對稱。

範圍限制。開啟 Max 後會先與容器尺寸取交集,再用 _mxSet() 把上下左右的可用距離算成函式,因為轉向時需要重新計算。

精簡後的核心結構

var Resize = Class.create();
Resize.prototype = {
  initialize: function (obj, options) {
    this._obj = $(obj);
    this._styleWidth = this._styleHeight = this._styleLeft = this._styleTop = 0;
    this._sideRight = this._sideDown = this._sideLeft = this._sideUp = 0;
    this._fixLeft = this._fixTop = 0;
    this._scaleLeft = this._scaleTop = 0;
    this._mxSet = function () {};
    this._fun  = function () {};

    var _style = CurrentStyle(this._obj);
    this._borderX = (parseInt(_style.borderLeftWidth) || 0) + (parseInt(_style.borderRightWidth) || 0);
    this._borderY = (parseInt(_style.borderTopWidth)  || 0) + (parseInt(_style.borderBottomWidth) || 0);

    this._fR = BindAsEventListener(this, this.Resize);
    this._fS = Bind(this, this.Stop);
    this.SetOptions(options);

    this.Max = !!this.options.Max;
    this._mxContainer = $(this.options.mxContainer) || null;
    this.mxLeft   = Math.round(this.options.mxLeft);
    this.mxRight  = Math.round(this.options.mxRight);
    this.mxTop    = Math.round(this.options.mxTop);
    this.mxBottom = Math.round(this.options.mxBottom);

    this.Min = !!this.options.Min;
    this.minWidth  = Math.round(this.options.minWidth);
    this.minHeight = Math.round(this.options.minHeight);

    this.Scale = !!this.options.Scale;
    this.Ratio = Math.max(this.options.Ratio, 0);
    this.onResize = this.options.onResize;

    this._obj.style.position = "absolute";
    !this._mxContainer || CurrentStyle(this._mxContainer).position == "relative"
      || (this._mxContainer.style.position = "relative");
  },
  SetOptions: function (options) {
    this.options = {
      Max: false, mxContainer: "",
      mxLeft: 0, mxRight: 9999, mxTop: 0, mxBottom: 9999,
      Min: false, minWidth: 50, minHeight: 50,
      Scale: false, Ratio: 0,
      onResize: function () {}
    };
    Extend(this.options, options || {});
  },
  Set: function (resize, side) {
    var resize = $(resize), fun;
    if (!resize) return;
    switch (side.toLowerCase()) {
      case "up":         fun = this.Up;         break;
      case "down":       fun = this.Down;       break;
      case "left":       fun = this.Left;       break;
      case "right":      fun = this.Right;      break;
      case "left-up":    fun = this.LeftUp;     break;
      case "right-up":   fun = this.RightUp;    break;
      case "left-down":  fun = this.LeftDown;   break;
      case "right-down":
      default:           fun = this.RightDown;
    }
    addEventHandler(resize, "mousedown", BindAsEventListener(this, this.Start, fun));
  },
  Start: function (e, fun, touch) {
    e.stopPropagation ? e.stopPropagation() : (e.cancelBubble = true);
    this._fun = fun;
    this._styleWidth  = this._obj.clientWidth;
    this._styleHeight = this._obj.clientHeight;
    this._styleLeft   = this._obj.offsetLeft;
    this._styleTop    = this._obj.offsetTop;
    this._sideLeft = e.clientX - this._styleWidth;
    this._sideRight = e.clientX + this._styleWidth;
    this._sideUp    = e.clientY - this._styleHeight;
    this._sideDown  = e.clientY + this._styleHeight;
    this._fixLeft = this._styleLeft + this._styleWidth;
    this._fixTop  = this._styleTop + this._styleHeight;

    if (this.Scale) {
      this.Ratio = Math.max(this.Ratio, 0) || this._styleWidth / this._styleHeight;
      this._scaleLeft = this._styleLeft + this._styleWidth  / 2;
      this._scaleTop  = this._styleTop  + this._styleHeight / 2;
    }
    if (this.Max) {
      var mxLeft = this.mxLeft, mxRight = this.mxRight,
          mxTop = this.mxTop, mxBottom = this.mxBottom;
      if (!!this._mxContainer) {
        mxLeft   = Math.max(mxLeft, 0);
        mxTop    = Math.max(mxTop, 0);
        mxRight  = Math.min(mxRight,  this._mxContainer.clientWidth);
        mxBottom = Math.min(mxBottom, this._mxContainer.clientHeight);
      }
      mxRight  = Math.max(mxRight,  mxLeft + (this.Min ? this.minWidth  : 0) + this._borderX);
      mxBottom = Math.max(mxBottom, mxTop  + (this.Min ? this.minHeight : 0) + this._borderY);
      this._mxSet = function () {
        this._mxRightWidth  = mxRight  - this._styleLeft - this._borderX;
        this._mxDownHeight  = mxBottom - this._styleTop  - this._borderY;
        this._mxUpHeight    = Math.max(this._fixTop  - mxTop,  this.Min ? this.minHeight : 0);
        this._mxLeftWidth   = Math.max(this._fixLeft - mxLeft, this.Min ? this.minWidth  : 0);
      };
      this._mxSet();
      if (this.Scale) {
        this._mxScaleWidth  = Math.min(this._scaleLeft - mxLeft,
                                       mxRight - this._scaleLeft - this._borderX) * 2;
        this._mxScaleHeight = Math.min(this._scaleTop  - mxTop,
                                       mxBottom - this._scaleTop - this._borderY) * 2;
      }
    }
    addEventHandler(document, "mousemove", this._fR);
    addEventHandler(document, "mouseup", this._fS);
    if (isIE) {
      addEventHandler(this._obj, "losecapture", this._fS);
      this._obj.setCapture();
    } else {
      addEventHandler(window, "blur", this._fS);
      e.preventDefault();
    }
  },
  Resize: function (e) {
    window.getSelection ? window.getSelection().removeAllRanges() : document.selection.empty();
    this._fun(e);
    with (this._obj.style) {
      width  = this._styleWidth  + "px";
      height = this._styleHeight + "px";
      top    = this._styleTop    + "px";
      left   = this._styleLeft   + "px";
    }
    this.onResize();
  },
  // 右 / 左 / 上 / 下 與四個斜角,各自呼叫 RepairX、RepairY、RepairAngle
  Right:      function (e) { this.RepairX(e.clientX - this._sideLeft, this._mxRightWidth);
                              this.TurnLeft(this.Left); },
  Left:       function (e) { this.RepairX(this._sideRight - e.clientX, this._mxLeftWidth);
                              this.RepairLeft(); this.TurnRight(this.Right); },
  Up:         function (e) { this.RepairY(this._sideDown - e.clientY, this._mxUpHeight);
                              this.RepairTop(); this.TurnDown(this.Down); },
  Down:       function (e) { this.RepairY(e.clientY - this._sideUp, this._mxDownHeight);
                              this.TurnUp(this.Up); },
  RightDown:  function (e) { this.RepairAngle(e.clientX - this._sideLeft, this._mxRightWidth,
                                              e.clientY - this._sideUp,   this._mxDownHeight);
                              this.TurnLeft(this.LeftDown) || this.Scale || this.TurnUp(this.RightUp); },
  // 其餘三個斜角寫法對稱,此處省略
  // 尺寸修正
  RepairHeight: function (iHeight, mxHeight) {
    iHeight = Math.min(this.Max ? mxHeight : iHeight, iHeight);
    return Math.max(this.Min ? this.minHeight : iHeight, iHeight, 0);
  },
  RepairWidth: function (iWidth, mxWidth) {
    iWidth = Math.min(this.Max ? mxWidth : iWidth, iWidth);
    return Math.max(this.Min ? this.minWidth : iWidth, iWidth, 0);
  },
  RepairScaleHeight: function (iWidth) {
    return Math.max(Math.round((iWidth + this._borderX) / this.Ratio - this._borderY), 0);
  },
  RepairScaleWidth: function (iHeight) {
    return Math.max(Math.round((iHeight + this._borderY) * this.Ratio - this._borderX), 0);
  },
  // 轉向
  TurnRight: function (fun) {
    if (!(this.Min || this._styleWidth)) {
      this._fun = fun; this._sideLeft = this._sideRight;
      this.Max && this._mxSet(); return true;
    }
  },
  Stop: function () {
    removeEventHandler(document, "mousemove", this._fR);
    removeEventHandler(document, "mouseup", this._fS);
    if (isIE) {
      removeEventHandler(this._obj, "losecapture", this._fS);
      this._obj.releaseCapture();
    } else {
      removeEventHandler(window, "blur", this._fS);
    }
  }
};

呼叫方式

<style type="text/css">
#rRightDown,#rLeftDown,#rLeftUp,#rRightUp,#rRight,#rLeft,#rUp,#rDown {
  position:absolute; background:#C00; width:7px; height:7px; 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; }
#rLeftDown { left:-4px;  bottom:-4px; }
#rRightUp  { right:-4px; top:-4px; }
#rRightDown{ right:-4px; bottom:-4px; background-color:#00F; }
#rLeftUp   { left:-4px;  top:-4px; }
#rRight { right:-4px; top:50%; margin-top:-4px; }
#rLeft  { left:-4px;  top:50%; margin-top:-4px; }
#rUp    { top:-4px;   left:50%; margin-left:-4px; }
#rDown  { bottom:-4px;left:50%; margin-left:-4px; }
#bgDiv   { width:600px; height:300px; border:10px solid #666; position:relative; }
#dragDiv { border:1px solid #000; width:100px; height:60px; top:50px; left:50px; background:#fff; }
</style>

<div id="bgDiv">
  <div id="dragDiv">
    <div id="rRightDown"></div><div id="rLeftDown"></div>
    <div id="rRightUp"></div><div id="rLeftUp"></div>
    <div id="rRight"></div><div id="rLeft"></div>
    <div id="rUp"></div><div id="rDown"></div>
  </div>
</div>
<input id="idScale" type="button" value="設置比例" />
<input id="idMin" type="button" value="設置最小範圍" />

<script>
var rs = new Resize("dragDiv", { Max: true, mxContainer: "bgDiv" });
rs.Set("rRightDown", "right-down");
rs.Set("rLeftDown",  "left-down");
rs.Set("rRightUp",   "right-up");
rs.Set("rLeftUp",    "left-up");
rs.Set("rRight", "right"); rs.Set("rLeft", "left");
rs.Set("rUp", "up");          rs.Set("rDown", "down");

$("idScale").onclick = function () {
  if (rs.Scale) { this.value = "設置比例";   rs.Scale = false; }
  else          { this.value = "取消比例";   rs.Ratio = 0; rs.Scale = true; }
};
$("idMin").onclick = function () {
  if (rs.Min) { this.value = "設置最小範圍"; rs.Min = false; }
  else        { this.value = "取消最小範圍"; rs.Min = true; }
};
</script>

從這份程式能學到什麼,又有哪些該改

值得學的是它把「狀態記錄 → 計算 → 套用 → 收尾」拆得很乾淨,並用 closure 保存 this,讓事件回呼不會指錯對象;轉向處理與容器夾限這兩個細節,更是自己寫過拖曳元件才會體會到的痛點。

但這份程式放到今天有幾個明顯該淘汰的地方:一是 with 語法在嚴格模式下無法使用;二是 mousemove 中直接改 width/height/left/top 會觸發重排,應該改用 transform: translate() scale() 並加上 will-change;三是沒有處理觸控裝置,今天必須搭配 Pointer Events(pointerdown / pointermove / pointerup 加上 setPointerCapture)才能同時支援滑鼠、觸控與手寫筆;四是缺少鍵盤操作,對使用輔助工具的人不友善。

如果你只是需要一個能縮放的區塊,直接用 CSS 的 resize: both 加上 overflow: auto 就足夠;需要更完整的互動則建議使用成熟的函式庫。但若要真正弄懂拖曳互動的每一個環節,手刻一次像這樣的元件,收穫會遠比套用套件來得多。

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