DIV CSS 佈局教程網

自己寫一個表格排序外掛:閉包、懶模式與排序規則設定
編輯:關於JavaScript     

為什麼要自己寫

先前評估過幾種方案:jQuery 的表格排序外掛(用法不太清楚,而且感覺麻煩)、原生 JS 的排序外掛等。最後選了一個原生版本,在其基礎上稍作修改。有些地方用起來還算順手,整體勉強達標。

直到前兩天,我在表格上加了「隔行換色」功能,效果立刻錯亂。檢查後發現問題出在該排序外掛上——原始碼寫得不好理解,與其修改還不如重寫一個。說寫就寫。

其實表格排序並不難:取出排序列的值存進陣列,同時把各列對應的列物件也存進另一個陣列,接著對值陣列排序,並同步調整列物件陣列的順序即可。

外掛程式碼

/**
 * @description 表格排序實作
 * @date 2011-10-28
 **/
(function () {
  var _initConfig = null;
  var _tableObj = null, _tbodyObj = null, _tBodyIndex = 0;
  // 存放各排序方式下的(有序)列陣列,僅在 IsLazyMode = true 時有用
  var _trJqObjArray_Obj = null;

  // 取出排序行的值陣列,同時收集列物件
  function _GetOrderTdValueArray(trJqObjArr, tdIndex, td_valAttr, td_dataType) {
    var tdOrderValArr = new Array();
    _tbodyObj.find("tr").each(function (i, trItem) {
      var trObj = $(trItem);
      trJqObjArr.push(trObj);
      var tdObj = $(trObj.find("td")[tdIndex]);
      var tdVal = td_valAttr ? tdObj.attr(td_valAttr) : tdObj.text();
      tdOrderValArr.push(_GetValue(tdVal, td_dataType));
    });
    return tdOrderValArr;
  }

  function _GetJqObjById(id) {
    return "string" == typeof (id) ? $("#" + id) : $(id);
  }

  // 排序主體
  function _Sort(tdIndex, options) {
    var trJqObjArr = null;
    if (_initConfig.IsLazyMode) {
      !_trJqObjArray_Obj && (_trJqObjArray_Obj = {});
      trJqObjArr = _trJqObjArray_Obj[tdIndex];
    }
    var isExist_trJqObjArr = true;
    if (!trJqObjArr) {
      isExist_trJqObjArr = false;
      trJqObjArr = new Array();
      var tdOrderValArr = _GetOrderTdValueArray(trJqObjArr, tdIndex, options.ValAttr, options.DataType);
      var sort_len = tdOrderValArr.length - 1;
      var isExchanged = false, compareOper = options.Desc ? ">" : "<";
      for (var i = 0; i < sort_len; i++) {
        isExchanged = false;
        for (var j = sort_len; j > i; j--) {
          if (eval(tdOrderValArr[j] + compareOper + tdOrderValArr[j - 1])) {
            _ExchangeArray(tdOrderValArr, j);
            _ExchangeArray(trJqObjArr, j);   // 同步交換列物件順序
            isExchanged = true;
          }
        }
        if (!isExchanged) break;   // 一輪未交換即可提前結束
      }
      _initConfig.IsLazyMode && (_trJqObjArray_Obj[tdIndex] = trJqObjArr);
    }
    if (trJqObjArr) {
      if (options.Toggle) {
        // 已有快取時直接反轉即可,不必重排
        _initConfig.IsLazyMode && isExist_trJqObjArr && trJqObjArr.reverse();
        options.Desc = !options.Desc;
      }
      _ShowTable(trJqObjArr);
    }
  }

  // 重新渲染 tbody
  function _ShowTable(trJqObjArr) {
    _tbodyObj.html("");
    for (var n = 0, len = trJqObjArr.length; n < len; n++) {
      _tbodyObj.append(trJqObjArr[n]);
      $.isFunction(_initConfig.OnShow) && (_initConfig.OnShow(n, trJqObjArr[n], _tbodyObj));
    }
  }

  function _ExchangeArray(array, j) {
    var temp = array[j];
    array[j] = array[j - 1];
    array[j - 1] = temp;
  }

  // 依型別把值標準化,確保比較方向正確
  function _GetValue(tdVal, td_dataType) {
    switch (td_dataType) {
      case "int":    return parseInt(tdVal, 10) || 0;
      case "float":  return parseFloat(tdVal) || 0;
      case "date":   return Date.parse(tdVal) || 0;
      case "string":
      default:       return tdVal.toString() || "";
    }
  }

  // 為某個觸發元素綁定排序
  function _SetOrder(obj, index, options) {
    var orderSettings = {
      ValAttr: false,      // 排序取值屬性,預設取 innerText
      DataType: "string",  // int | float | date | string
      OnClick: null,       // 排序時的 callback
      Desc: true,          // 是否降序
      Toggle: true,        // 是否切換排序方向
      DefaultOrder: false  // 是否為預設排序
    };
    $.extend(orderSettings, options);
    orderSettings.DataType = orderSettings.DataType.toLowerCase();
    obj = _GetJqObjById(obj);
    obj.bind("click", function () {
      _Sort(index, orderSettings);
      $.isFunction(orderSettings.OnClick) && orderSettings.OnClick();
    });
    orderSettings.DefaultOrder && _Sort(index, orderSettings);
  }

  var _api = {
    Init: function (obj, tBodyIndex, options) {
      if (obj == null || typeof (obj) == undefined) {
        alert("TableOrder 初始化參數為空或有誤!");
        return;
      }
      _tableObj = _GetJqObjById(obj);
      _tBodyIndex = tBodyIndex || 0;
      _tbodyObj = _tableObj.find("tbody:eq(" + _tBodyIndex + ")");
      options = options || {};
      _initConfig = {
        IsLazyMode: true,   // 懶模式
        OnShow: null        // 渲染後 callback: (trIndex, trJqObj, tbodyObj)
      };
      $.extend(_initConfig, options);
      _trJqObjArray_Obj = null;
    },
    SetOrder: function (obj, index, options) {
      if (_tableObj == null) {
        alert("_tableObj 尚未初始化!");
        return;
      }
      _SetOrder(obj, index, options);
    }
  };
  window.TableOrderOper = _api;
})();

使用方式

<table id="idTable">
<thead>
<tr>
  <td><a href="javascript:void(0)" id="idTitle">名稱</a>
      / <a href="javascript:void(0)" id="idExt">類型</a></td>
  <td><a href="javascript:void(0)" id="idAddtime">上傳時間</a></td>
  <td><a href="javascript:void(0)" id="idSize">大小</a></td>
</tr>
</thead>
<tbody>
<tr class="hoverTr">
  <td _ext="rar">JSCSS</td>
  <td _order="2008/9/12 8:51:09">2008/9/12 8:51:09</td>
  <td _order="433247">433247</td>
</tr>
<tr>
  <td _ext="htm">AJAX</td>
  <td _order="2008/3/6 20:12:23">2008/3/6 20:12:23</td>
  <td _order="11394">11394</td>
</tr>
</tbody>
</table>

<script src="../Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>
<script src="TableOrder.js" type="text/javascript"></script>
<script type="text/javascript">
TableOrderOper.Init("idTable", 0, {
  OnShow: function (i, trJqObj, _tbodyObj) {
    trJqObj.attr("class", ((i + 1) % 2 == 0 ? "hoverTr" : ""));
  }
});
TableOrderOper.SetOrder("idAddtime", 1, { ValAttr: "_order", DataType: "date" });
TableOrderOper.SetOrder("idSize", 2, {
  DataType: "int",
  DefaultOrder: true,
  OnClick: function () { alert("idSize"); }
});
</script>

幾點設計說明

  1. 整份程式碼包在閉包裡,只對外暴露 TableOrderOper,其餘一律私有。
  2. IsLazyMode:true 適合排序目標固定、不會有 Ajax 增刪列的表格。好處是排序列的值與列物件只需遍歷一次,排序後的列物件陣列會快取在全域物件中,下次點擊同一列時直接取出並 reverse() 即可,省下重排成本。false 則適合會動態變動的表格。
  3. 一般表格資料量不大,因此排序採用冒泡排序,並加入「一輪未交換即提前結束」的優化。
  4. OnShow 回呼讓隔行換色等樣式可以在渲染後套用,兼顧效能與彈性——這正是先前那個外掛做不到、導致樣式錯亂的原因。

以今日角度補充兩點:用 eval 進行比較是這份程式碼最值得改掉的地方,改成 tdOrderValArr[j] > tdOrderValArr[j-1] 的型別化比較即可,既安全又更快;自訂的 _ext、_order 屬性在 HTML5 下應改用 data-ext、data-order。至於排序演算法,若資料量可能變大,直接呼叫原生 Array.prototype.sort 會比冒泡排序合適得多。

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