DIV CSS 佈局教程網

Bootstrap Table 多行拖拽實作:從可用到精準定位的優化歷程
編輯:關於JavaScript     

繼上一篇完成「單行拖拽」之後,這次的需求升級了:要能一次把多筆勾選的資料拖到目標表格中。折騰了半天做出來,效果能用但不夠漂亮,先把過程完整記錄下來,後面再逐步優化。

一、效果預覽

1、拖動前

2、拖動中

3、拖動後

4、撤銷回到拖動前的狀態

二、需求解析:為什麼拖的是 tbody

拖拽的前提是有一個「可拖拽的容器」。單行拖拽時,tr 自己就是容器;但多行拖拽時,直覺做法是把選中的幾個 tr 包進一個 div 裡,再讓這個 div 可拖。

實測行不通:tr 是 table 的合法子元素,外面套一層 div 會直接破壞表格結構,樣式全亂。

換個角度想:tr 的父層級其實是 tbody,而 tbody 本身就能容納多個 tr。於是改成讓 tbody 可拖拽 —— 實測可行,方向就此確定。

三、核心代碼

cshtml 部分與上一篇相同,這裡只看 JavaScript。

var i_statuindex = 0;
var arrdata = [];
var m_oTable = null;

$(function () {
    // 1.初始化表格
    m_oTable = new TableInit();
    m_oTable.Init();

    // 2.初始化按鈕事件
    var oButtonInit = new ButtonInit();
    oButtonInit.Init();

    // 3.日期控件
    $(".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 (data) {
                oTableInit.InitDrag();
                if (data.total > 0) {
                    var iheight = $('#div_tableleft').find(".fixed-table-container").height();
                    $('#div_tableleft').find(".fixed-table-container").height(iheight + 36);
                }
            },
            onCheckAll: function () { $("#tb_order_left tbody tr").addClass("selected"); },
            onUncheckAll: function () { $("#tb_order_left tbody tr").removeClass("selected"); }
        });

        $('#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(); }
        });
    };

    // 註冊左側 tbody 可拖拽
    oTableInit.InitDrag = function () {
        $('#tb_order_left tbody').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);
                // 優化點:拖動時隱藏未選中的行
                $(ui.helper[0]).find("tr[class!=selected]").remove();
            },
            stop: function () { }
        });
    };

    // 註冊右側 drop
    oTableInit.InitDrop = function () {
        $("#div_tableright div[class=fixed-table-container]").droppable({
            drop: function (event, ui) {
                var arrtr = $(ui.helper[0]).find("tr[class=selected]");
                if (arrtr.length <= 0) {
                    toastr.warning('請先選中要插單的行');
                    return;
                }
                var oTop = ui.helper[0].offsetTop;
                var rowIndex = 0;
                var bIsBottom = true;
                var iRowHeadHeight = 40;
                var addHeight = iRowHeadHeight;
                var trs = $("#tb_order_right tbody tr");
                // 逐行累加行高,找出插入位置
                for (var i = 0; i < trs.length; i++) {
                    addHeight += $(trs[i]).height();
                    if (addHeight > oTop) {
                        rowIndex = i;
                        bIsBottom = false;
                        break;
                    }
                }
                if (bIsBottom) { rowIndex = trs.length; }

                for (var i = 0; i < arrtr.length; i++) {
                    var arrtd = $(arrtr[i]).find("td");
                    var uniqueid = $(arrtr[i]).attr("data-uniqueid");
                    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_NAME: $(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: uniqueid,
                        ORDER_STATUS: 0
                    };
                    $("#tb_order_right").bootstrapTable("insertRow", { index: rowIndex++, row: rowdata });
                    $('#tb_order_left').bootstrapTable("removeByUniqueId", uniqueid);
                }
                oTableInit.InitDrag();
            }
        });
    };

    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);
                for (var x = 0; x < arr_right_data.length; x++) {
                    $("#tb_order_right").bootstrapTable("insertRow", { index: x, row: arr_right_data[x] });
                }
                // 注意:append 之後的元素無法再 drop,所以右邊逐行 insertRow
                break;
            }
            i_statuindex--;
            m_oTable.InitDrag(); // 重新註冊拖拽
        });
    };
    return oInit;
};

四、三個容易踩坑的地方

1、drop 要綁在外層容器上。直接綁 #tb_order_right 會發現拖過去沒有反應 —— 這個元素的作用域太小,拖過來的 tbody 捕捉不到 drop 事件。改綁 Bootstrap Table 自動生成的 #div_tableright div[class=fixed-table-container] 就正常了。

2、插入位置要靠計算。用 ui.helper[0].offsetTop 拿到滑鼠的 Y 座標,再與表頭高度、各行高度做比較,才能算出該插到第幾列。

3、行高不是固定值。第一版用「表頭高 40 + 單行行高 37」做除法估算,遇到內容換行的列就偏了。優化版改成把右邊表格每一列的高度逐行累加,超過滑鼠位置的那一行就是插入點;若全部累加完都沒超過,說明拖到了最底部,直接放在 trs.length。

五、優化後的兩處改動

1、拖動時只顯示選中的行。在 start 裡加一句:

$(ui.helper[0]).find("tr[class!=selected]").remove();

這樣拖拽過程中就不會看到那些沒勾選的列,視覺上清爽很多。

2、精準定位插入位置。如上一節所示,改成動態累加行高的寫法,並用 bIsBottom 標記「拖到最底部」這種邊界情況。

六、小結

功能跑通了,但仍有遺憾:每次拖過去的是整個 tbody,只是視覺上把未選中的行隱藏了,本質上並不是「只拖選中的行」。多個 tr 無法用單一容器合法包裝,這是 HTML 結構層面的限制。目前先停在這個階段,之後若有更好的思路再回頭優化。

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