DIV CSS 佈局教程網

Bootstrap Table 跨表格行拖拽與撤銷(Ctrl+Z)實作全解
編輯:關於JavaScript     

一、業務場景

專案裡的訂單模組有個特殊需求:兩種不同狀態的訂單之間要能「插單」。頁面上是左右兩張 Table,左邊放狀態為 1 的訂單,右邊放狀態為 2 的訂單;把左邊某列拖到右邊的指定位置,拖完左邊少一列、右邊多一列。此外還要支援撤銷,也就是像 Ctrl + Z 那樣退回上一步。

先來看成果。

1、拖動之前

2、正在拖動左邊的列

3、第一次拖動完成

4、第二、三次拖動完成

5、點擊撤銷

6、多次撤銷回到初始狀態

二、先查官方,再自己動手

接到需求的第一反應是翻 Bootstrap Table 的 API,畢竟開源的東西說不定已經有人做過。結果沒有找到跨表格的拖拽方案 —— 仔細想想也合理,Bootstrap Table 的定位是「單一表格的資料綁定與內部操作」,它對表格內部的列排序(Reorder Rows)有現成方案,但跨表格搬移資料確實超出了它的職責範圍。

1、需求拆解

兩個難點:

拖拽 —— 用 jQuery UI 的 draggable 和 droppable 就能解決,這兩個組件在 JsPlumb 時期就用得很熟了。

撤銷 —— 撤銷的本質是「回到上一步」,前提是得先把上一步的狀態存下來。於是用一個全域陣列保存每一步的快照,每筆快照包含三個部分:步驟索引、左邊表格的資料、右邊表格的資料。

2、cshtml 頁面結構

<script src="~/Content/jquery-ui-1.11.4.custom/jquery-ui.min.js"></script>

<div id="toolbar_right" class="btn-group">
  <button id="btn_cancel" type="button" class="btn btn-default">
    <span class="glyphicon glyphicon-backward"></span>撤銷
  </button>
  <button id="btn_insertorder" type="button" class="btn btn-default">
    <span class="glyphicon glyphicon-plus"></span>插單
  </button>
</div>

<div class="panel-body" style="padding-top:0px;">
  <div id="div_tableleft" class="col-md-6">
    <table id="tb_order_left"></table>
  </div>
  <div id="div_tableright" class="col-md-6">
    <table id="tb_order_right"></table>
  </div>
</div>

查詢條件區(訂單號、車身號、VIN 碼、發動機號,以及可展開的導入時間、下發時間等)與一般 Bootstrap 表單無異,這裡不再重複貼。

3、JavaScript 主體

var i_statuindex = 0; // 記錄當前步驟索引
var arrdata = [];     // 保存每一步的左右表格快照
var m_oTable = null;

$(function () {
    m_oTable = new TableInit();
    m_oTable.Init();
    var oButtonInit = new ButtonInit();
    oButtonInit.Init();
    $(".datetimepicker").datetimepicker({ format: 'yyyy-mm-dd hh:ii', autoclose: true, todayBtn: true });
});

var TableInit = function () {
    var oTableInit = new Object();

    oTableInit.Init = function () {
        // 左邊表格
        $('#tb_order_left').bootstrapTable({
            url: '/api/OrderApi/get', method: 'get',
            striped: true, cache: false, pagination: true, height: 600,
            uniqueId: "TO_ORDER_ID",
            queryParams: oTableInit.queryParams, queryParamsType: "limit",
            sidePagination: "server", pageSize: 10, pageList: [10, 25, 50, 100],
            search: true, strictSearch: true, showColumns: true, showRefresh: true,
            minimumCountColumns: 2, clickToSelect: true,
            columns: [{ checkbox: true },
                { field: 'ORDER_NO', title: '訂單號' },
                { field: 'BODY_NO', title: '車身號' },
                { field: 'VIN', title: 'VIN碼' },
                { field: 'TM_MODEL_MATERIAL_ID', title: '整車編碼' },
                { field: 'ORDER_TYPE', title: '訂單類型' },
                { field: 'ORDER_STATUS', title: '訂單狀態' },
                { field: 'CREATE_DATE', title: '訂單導入時間' },
                { field: 'PLAN_DATE', title: '訂單計劃上線日期' },
                { field: 'VMS_NO', title: 'VMS號' },
                { field: 'ENGIN_CODE', title: '發動機號' },
                { field: 'TRANS_CODE', title: '變速箱號' },
                { field: 'OFFLINE_DATE_ACT', title: '實際下線日期' },
                { field: 'HOLD_RES', title: 'hold理由' },
                { field: 'SPC_FLAG', title: '特殊標記' }],
            onLoadSuccess: function () {
                // 表格載入完成後才註冊拖拽,否則抓不到 tr
                oTableInit.InitDrag();
            }
        });

        // 右邊表格
        $('#tb_order_right').bootstrapTable({
            url: '/api/OrderApi/get', method: 'get', toolbar: '#toolbar_right',
            striped: true, cache: false, pagination: true, height: 600,
            queryParams: oTableInit.queryParamsRight, queryParamsType: "limit",
            sidePagination: "server", pageSize: 10, pageList: [10, 25, 50, 100],
            search: true, strictSearch: true, showRefresh: true, minimumCountColumns: 2,
            columns: [
                { field: 'ORDER_NO', title: '訂單號' },
                { field: 'BODY_NO', title: '車身號' },
                { field: 'VIN', title: 'VIN碼' },
                { field: 'TM_MODEL_MATERIAL_ID', title: '整車編碼' },
                { field: 'ORDER_TYPE', title: '訂單類型' },
                { field: 'ORDER_STATUS', title: '訂單狀態' },
                { field: 'CREATE_DATE', title: '訂單導入時間' },
                { field: 'PLAN_DATE', title: '訂單計劃上線日期' },
                { field: 'VMS_NO', title: 'VMS號' },
                { field: 'ENGIN_CODE', title: '發動機號' },
                { field: 'TRANS_CODE', title: '變速箱號' },
                { field: 'OFFLINE_DATE_ACT', title: '實際下線日期' },
                { field: 'HOLD_RES', title: 'hold理由' },
                { field: 'SPC_FLAG', title: '特殊標記' }],
            onLoadSuccess: function () { oTableInit.InitDrop(); }
        });
    };

    // 左邊表格註冊 draggable
    oTableInit.InitDrag = function () {
        $('#tb_order_left tr').draggable({
            helper: "clone",
            start: function (event, ui) {
                var odata = {
                    index: ++i_statuindex,
                    left_data: JSON.stringify($('#tb_order_left').bootstrapTable("getData")),
                    right_data: JSON.stringify($('#tb_order_right').bootstrapTable("getData"))
                };
                arrdata.push(odata);
            },
            stop: function () { }
        });
    };

    // 右邊表格註冊 droppable
    oTableInit.InitDrop = function () {
        $("#tb_order_right").droppable({
            drop: function (event, ui) {
                var arrtd = $(ui.helper[0]).find("td");
                var rowdata = {
                    ORDER_NO: $(arrtd[1]).text(),
                    BODY_NO: $(arrtd[2]).text(),
                    VIN: $(arrtd[3]).text(),
                    TM_MODEL_MATERIAL_ID: $(arrtd[4]).text(),
                    ORDER_TYPE: $(arrtd[5]).text(),
                    ORDER_STATUS: $(arrtd[6]).text(),
                    CREATE_DATE: $(arrtd[7]).text() == "-" ? null : $(arrtd[7]).text(),
                    PLAN_DATE: $(arrtd[8]).text() == "-" ? null : $(arrtd[8]).text(),
                    VMS_NO: $(arrtd[9]).text(),
                    ENGIN_CODE: $(arrtd[10]).text(),
                    TRANS_CODE: $(arrtd[11]).text(),
                    OFFLINE_DATE_ACT: $(arrtd[12]).text() == "-" ? null : $(arrtd[12]).text(),
                    HOLD_RES: $(arrtd[13]).text(),
                    SPC_FLAG: $(arrtd[14]).text(),
                    TO_ORDER_ID: $(ui.helper[0]).attr("data-uniqueid")
                };
                var oTop = ui.helper[0].offsetTop;
                var iRowHeadHeight = 40;
                var iRowHeight = 37;
                var rowIndex = 0;
                if (oTop <= iRowHeadHeight + iRowHeight / 2) {
                    rowIndex = 0;
                } else {
                    rowIndex = Math.ceil((oTop - iRowHeadHeight) / iRowHeight);
                }
                $("#tb_order_right").bootstrapTable("insertRow", { index: rowIndex, row: rowdata });
                $('#tb_order_left').bootstrapTable("removeByUniqueId", $(ui.helper[0]).attr("data-uniqueid"));
                oTableInit.InitDrag(); // 重新註冊,讓新生成的 tr 也能拖
            }
        });
    };

    oTableInit.queryParams = function (params) {
        return {
            limit: params.limit, offset: params.offset,
            strBodyno: $("#txt_search_bodynumber").val(),
            strVin: $("#txt_search_vinnumber").val(),
            strOrderno: $("#txt_search_ordernumber").val(),
            strEngincode: $("#txt_search_engin_code").val(),
            strOrderstatus: 0,
            strTranscode: $("#txt_search_trans_code").val(),
            strVms: $("#txt_search_vms").val(),
            strCarcode: $("#txt_search_carcode").val(),
            strImportStartdate: $("#txt_search_import_startdate").val(),
            strImportEnddate: $("#txt_search_import_enddate").val(),
            strSendStartdate: $("#txt_search_send_startdate").val(),
            strSendEnddate: $("#txt_search_send_enddate").val()
        };
    };

    oTableInit.queryParamsRight = function (params) {
        return {
            limit: params.limit, offset: params.offset,
            strBodyno: "", strVin: "", strOrderno: "", strEngincode: "",
            strOrderstatus: 5, strTranscode: "", strVms: "", strCarcode: "",
            strImportStartdate: "", strImportEnddate: "",
            strSendStartdate: "", strSendEnddate: ""
        };
    };
    return oTableInit;
};

var ButtonInit = function () {
    var oInit = new Object();
    oInit.Init = function () {
        $("#btn_query").click(function () { $("#tb_order_left").bootstrapTable('refresh'); });
        $("#btn_reset").click(function () {
            $(".container-fluid").find(".form-control").val("");
            $("#tb_order_left").bootstrapTable('refresh');
        });

        // 撤銷
        $("#btn_cancel").click(function () {
            if (i_statuindex <= 0) return;
            for (var i = 0; i < arrdata.length; i++) {
                if (arrdata[i].index != i_statuindex) continue;
                var arr_left_data = eval(arrdata[i].left_data);
                var arr_right_data = eval(arrdata[i].right_data);
                $('#tb_order_left').bootstrapTable('removeAll');
                $('#tb_order_right').bootstrapTable('removeAll');
                $('#tb_order_left').bootstrapTable('append', arr_left_data);
                // 右邊不能用 append,append 之後的元素無法 drop,只能逐列 insertRow
                for (var x = 0; x < arr_right_data.length; x++) {
                    $("#tb_order_right").bootstrapTable("insertRow", { index: x, row: arr_right_data[x] });
                }
                break;
            }
            i_statuindex--;
            m_oTable.InitDrag();
        });

        // 展開/收起查詢條件
        $("#span_collapse").click(function () {
            if ($(this).text() == "收起") {
                $(this).html('展開<label class="glyphicon glyphicon-menu-down"></label>');
                $("#div_more_search").collapse('hide');
            } else {
                $(this).html('收起<label class="glyphicon glyphicon-menu-up"></label>');
                $("#div_more_search").collapse('show');
            }
        });
    };
    return oInit;
};

三、三個關鍵片段

2.2.1 拖拽開始時存快照

$('#tb_order_left tr').draggable({
    helper: "clone",
    start: function (event, ui) {
        var old_left_data = JSON.stringify($('#tb_order_left').bootstrapTable("getData"));
        var old_right_data = JSON.stringify($('#tb_order_right').bootstrapTable("getData"));
        var odata = { index: ++i_statuindex, left_data: old_left_data, right_data: old_right_data };
        arrdata.push(odata);
    },
    stop: function () { }
});

在 start 裡把左右兩張表的全部資料序列化存進 arrdata,同時用 i_statuindex 標記這是第幾步。撤銷時就靠這個索引對號入座。helper: "clone" 讓拖動時產生一個副本,原列留在原位,視覺上更自然。

2.2.2 放下時計算插入位置

$("#tb_order_right").droppable({
    drop: function (event, ui) {
        var arrtd = $(ui.helper[0]).find("td");
        var rowdata = { /* 逐欄位從 td 取文字,略 */ };
        var oTop = ui.helper[0].offsetTop;
        var iRowHeadHeight = 40;
        var iRowHeight = 37;
        var rowIndex = 0;
        if (oTop <= iRowHeadHeight + iRowHeight / 2) {
            rowIndex = 0;
        } else {
            rowIndex = Math.ceil((oTop - iRowHeadHeight) / iRowHeight);
        }
        $("#tb_order_right").bootstrapTable("insertRow", { index: rowIndex, row: rowdata });
        $('#tb_order_left').bootstrapTable("removeByUniqueId", $(ui.helper[0]).attr("data-uniqueid"));
        oTableInit.InitDrag();
    }
});

流程是:從拖過來的 clone 節點取出各欄文字 → 用 offsetTop 換算插入索引 → 右邊插入 → 左邊用 uniqueId 刪除 → 重新註冊拖拽。這裡的 - 判斷是為了把畫面上的佔位符還原成 null,避免髒資料寫進後端。

2.2.3 撤銷

$("#btn_cancel").click(function () {
    if (i_statuindex <= 0) return;
    for (var i = 0; i < arrdata.length; i++) {
        if (arrdata[i].index != i_statuindex) continue;
        var arr_left_data = eval(arrdata[i].left_data);
        var arr_right_data = eval(arrdata[i].right_data);
        $('#tb_order_left').bootstrapTable('removeAll');
        $('#tb_order_right').bootstrapTable('removeAll');
        $('#tb_order_left').bootstrapTable('append', arr_left_data);
        for (var x = 0; x < arr_right_data.length; x++) {
            $("#tb_order_right").bootstrapTable("insertRow", { index: x, row: arr_right_data[x] });
        }
        break;
    }
    i_statuindex--;
    m_oTable.InitDrag();
});

邏輯是:依索引取出對應快照 → 兩張表清空 → 依序回填 → 索引遞減,一路退到 0 就回到初始狀態。因為左邊表格的列全部重建過,所以必須重新註冊 draggable。

四、幾點經驗

拖拽一定要在 onLoadSuccess 之後註冊。伺服器分頁的表格,DOM 是 AJAX 回來才生成的,在 document.ready 裡綁定會抓不到元素。

每次拖完都要重新註冊。新插入的 tr 沒有綁過事件,不重新呼叫 InitDrag 就只能拖一次。

行高固定是這個版本的隱性假設。用 40(表頭)+ 37(列高)做除法,遇到內容換行的列會算錯。若你的表格有高度不固定的欄位,請改用逐行累加高度的方式來定位,做法可參考 Bootstrap Table 多行拖拽那一篇。

eval 解析快照不是好習慣。這裡為了示範方便沿用了 eval,正式專案請直接用 JSON.parse,既安全又高效。

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