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

2、正在拖動左邊的列

3、第一次拖動完成

4、第二、三次拖動完成


5、點擊撤銷

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

接到需求的第一反應是翻 Bootstrap Table 的 API,畢竟開源的東西說不定已經有人做過。結果沒有找到跨表格的拖拽方案 —— 仔細想想也合理,Bootstrap Table 的定位是「單一表格的資料綁定與內部操作」,它對表格內部的列排序(Reorder Rows)有現成方案,但跨表格搬移資料確實超出了它的職責範圍。
兩個難點:
拖拽 —— 用 jQuery UI 的 draggable 和 droppable 就能解決,這兩個組件在 JsPlumb 時期就用得很熟了。
撤銷 —— 撤銷的本質是「回到上一步」,前提是得先把上一步的狀態存下來。於是用一個全域陣列保存每一步的快照,每筆快照包含三個部分:步驟索引、左邊表格的資料、右邊表格的資料。
<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 表單無異,這裡不再重複貼。
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;
};
$('#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" 讓拖動時產生一個副本,原列留在原位,視覺上更自然。
$("#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,避免髒資料寫進後端。
$("#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,既安全又高效。