DIV CSS 佈局教程網

用 jQuery 打造 Bootstrap 可編輯表格:editTable.js 完整解析
編輯:關於JavaScript     

本文要分享的是一個自己寫的 editTable.js 小插件,它能替 Bootstrap 表格加上「編輯當前行」、「在下方新增一行」、「刪除當前行」這三種操作。因為把行為封裝成 jQuery 外掛,所以呼叫時可以透過參數調整細節。

可設定的參數有哪些

operatePos:決定操作按鈕放在第幾欄,索引從 0 起算,填 -1 代表放在最後一欄。這裡所謂的「操作」包含編輯、新增、刪除三種。

handleFirst:決定第一列是否也算操作對象,true 為是,false 為否。

edit / save / cancel / add / confirm / del:分別對應「編輯」、「保存」、「取消」、「添加」、「確認」、「刪除」的顯示文字,全部都可以自訂。

editableCols:指定哪些欄位允許編輯,索引從 0 起算並以陣列傳入,例如 [1, 2] 表示第 2、3 欄可編輯;也可以直接傳 "all" 代表全部欄位。程式會自動排除用來放操作按鈕的那一欄。

order:決定要啟用哪些操作以及排列順序,值可以是 edit、add、del。傳空陣列等同 ["edit"];不傳則預設三種全開,順序為編輯→添加→刪除。想改成 ["add", "edit", "del"] 也完全可以。

saveCallback:啟用編輯功能後,按下保存時觸發的回呼函式。實務上會在這裡寫 Ajax 把修改後的 data 送回後端,等儲存成功後記得呼叫參數中的 isSuccess,介面才會從可編輯狀態切回唯讀狀態。

addCallback 與 delCallback:邏輯與 saveCallback 相同,只是分別用在新增與刪除這兩個動作上。

editTable.js 原始碼

/**
 * Created by DreamBoy on 2016/4/19.
 */
$(function() {
    $.fn.handleTable = function (options) {
        //1.Settings 初始化設置
        var c = $.extend({
            "operatePos" : -1,          //-1表示默認操作列為最後一列
            "handleFirst" : false,      //第一行是否作為操作的對象
            "edit" : "編輯",
            "save" : "保存",
            "cancel" : "取消",
            "add" : "添加",
            "confirm" : "確認",
            "del" : "刪除",
            "editableCols" : "all",     //可編輯的列,從0開始
            "order" : ["edit", "add", "del"],   //指定三個功能的順序
            "saveCallback" : function(data, isSuccess) {
                //data: 返回的數據
                //isSuccess: 保存成功後將可編輯狀態變為不可編輯狀態
            },
            "addCallback" : function(data, isSuccess) {
                //isSuccess: 添加成功後將可編輯狀態變為不可編輯狀態
            },
            "delCallback" : function(isSuccess) {
                //isSuccess: 刪除成功後將對應行刪除
            }
        }, options);

        //表格的列數
        var colsNum = $(this).find('tr').last().children().size();

        //2.初始化操作列,默認為最後一列
        if(c.operatePos == -1) {
            c.operatePos = colsNum - 1;
        }

        //3.獲取所有需要被操作的行
        var rows = $(this).find('tr');
        if(!c.handleFirst) {
            rows = rows.not(":eq(0)");
        }

        //4.獲取放置「操作」的列
        var rowsTd = [];
        var allTd = rows.children();
        for(var i = c.operatePos; i <= allTd.size(); i += colsNum) {
            if(c.handleFirst) {
                allTd.eq(i).html("");
            }
            rowsTd.push(allTd.eq(i)[0]);
        }

        //6.修改設置 order 為空時的默認值
        if(c.order.length == 0) {
            c.order = ["edit"];
        }

        //7.保存可編輯的列
        var cols = getEditableCols();

        //8.初始化鏈接的構建
        var saveLink = "", cancelLink = "", editLink = "", addLink = "", confirmLink = "", delLink = "";
        initLink();

        //9.初始化操作
        initFunc(c.order, rowsTd);

        function createLink(str) {
            return "<a href=\"javascript:void(0)\" style=\"margin:0 3px\">" + str + "</a>";
        }

        function initLink() {
            for(var i = 0; i < c.order.length; i++) {
                switch (c.order[i]) {
                    case "edit":
                        editLink = createLink(c.edit);
                        saveLink = createLink(c.save);
                        cancelLink = createLink(c.cancel);
                        break;
                    case "add":
                        addLink = createLink(c.add);
                        confirmLink = createLink(c.confirm);
                        cancelLink = createLink(c.cancel);
                        break;
                    case "del":
                        delLink = createLink(c.del);
                        break;
                }
            }
        }

        function getEditableCols() {
            var cols = c.editableCols;
            if($.type(c.editableCols) != "array" && cols == "all") {
                cols = [];
                for(var i = 0; i < colsNum; i++) {
                    if(i != c.operatePos) {
                        cols.push(i);
                    }
                }
            } else if($.type(c.editableCols) == "array") {
                var copyCols = [];
                for(var i = 0; i < cols.length; i++) {
                    if(cols[i] != c.operatePos) {
                        copyCols.push(cols[i]);
                    }
                }
                cols = copyCols;
            }
            return cols;
        }

        function initFunc(func, cols) {
            for(var i = 0; i < func.length; i++) {
                var o = func[i];
                switch(o) {
                    case "edit": createEdit(cols); break;
                    case "add": createAdd(cols); break;
                    case "del": createDel(cols); break;
                }
            }
        }

        function createEdit(operateCol) {
            $(editLink).appendTo(operateCol).on("click", function() {
                if(replaceQuote($(this).html()) == replaceQuote(c.edit)) {
                    toSave(this);
                } else if(replaceQuote($(this).html()) == replaceQuote(c.save)) {
                    var p = $(this).parents('tr');
                    var data = [];
                    for(var i = 0; i < cols.length; i++) {
                        var tr = p.children().eq(cols[i]);
                        var inputValue = tr.children('input').val();
                        data.push(inputValue);
                    }
                    $this = this;
                    c.saveCallback(data, function() {
                        toEdit($this, true);
                    });
                }
            });

            var afterSave = [];

            function toSave(ele) {
                $(ele).html(c.save);
                $(ele).after(cancelLink);
                $(ele).next().on('click', function() {
                    toEdit(ele, false);
                });
                var p = $(ele).parents('tr');
                afterSave = [];
                for(var i = 0; i < cols.length; i++) {
                    var tr = p.children().eq(cols[i]);
                    var editTr = "<input type=\"text\" class=\"form-control\" value=\"" + tr.html() + "\"/>";
                    afterSave.push(tr.html());
                    tr.html(editTr);
                }
            }

            function toEdit(ele, isSave) {
                $(ele).html(c.edit);
                if(replaceQuote($(ele).next().html()) == replaceQuote(c.cancel)) {
                    $(ele).next().remove();
                }
                var p = $(ele).parents('tr');
                for(var i = 0; i < cols.length; i++) {
                    var tr = p.children().eq(cols[i]);
                    var value;
                    if(isSave) {
                        value = tr.children('input').val();
                    } else {
                        value = afterSave[i];
                    }
                    tr.html(value);
                }
            }
        }

        function createAdd(operateCol) {
            $(addLink).appendTo(operateCol).on("click", function() {
                var p = $(this).parents('tr');
                var copyRow = p.clone();
                var childLen = p.children().length;
                for(var i = 0; i < childLen; i++) {
                    copyRow.children().eq(i).html("<input type=\"text\" class=\"form-control\"/>");
                }
                var last = copyRow.children().eq(c.operatePos);
                last.html("");
                p.after(copyRow);
                var confirm = $(confirmLink).appendTo(last).on("click", function() {
                    var data = [];
                    for(var i = 0; i < childLen; i++) {
                        if(i != c.operatePos) {
                            var v = copyRow.children().eq(i).children("input").val();
                            data.push(v);
                            copyRow.children().eq(i).html(v);
                        }
                    }
                    c.addCallback(data, function() {
                        last.html("");
                        initFunc(c.order, last);
                    });
                });
                $(confirm).after(cancelLink);
                $(confirm).next().on('click', function() {
                    copyRow.remove();
                });
            });
        }

        function createDel(operateCol) {
            $(delLink).appendTo(operateCol).on("click", function() {
                var _this = this;
                c.delCallback(function() {
                    $(_this).parents('tr').remove();
                });
            });
        }

        function replaceQuote(str) {
            return str.replace(/\'/g, "\"");
        }
    };
});

使用上有兩個前提要注意:table 必須掛上能被選到的 class 或選擇器,並且要預留一個空的 <td></td> 用來放操作按鈕。

實際案例

目錄結構:

index.html

 <!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>表格</title>
<link rel="stylesheet" href="css/bootstrap.min.css" type="text/css">
<!--[if lt IE 9]>
<script src="js/html5shiv.js"></script>
<script src="js/respond.min.js"></script>
<![endif]-->
</head>
<body>
<div class="container">
<div class="bs-example" data-example-id="hoverable-table">
<table class="table table-hover editable">
<thead>
<tr>
<th>#</th>
<th>Test</th>
<th>First Name</th>
<th>Last Name</th>
<th>Username</th>
<th>Operations</th>
</tr>
</thead>
<tbody>
<tr>
<th scope="row">1</th>
<td></td>
<td>Mark</td>
<td>Otto</td>
<td>@mdo</td>
<td></td>
</tr>
<tr>
<th scope="row">2</th>
<td></td>
<td>Jacob</td>
<td>Thornton</td>
<td>@fat</td>
<td></td>
</tr>
<tr>
<th scope="row">3</th>
<td></td>
<td>Larry</td>
<td>the Bird</td>
<td>@twitter</td>
<td></td>
</tr>
</tbody>
</table>
</div>
</div>
<script src="js/jquery-1.11.1.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="editTable.js"></script>
<script>
$(function() {
    $('.editable').handleTable({
        "handleFirst" : true,
        "cancel" : " <span class='glyphicon glyphicon-remove'></span> ",
        "edit" : " <span class='glyphicon glyphicon-edit'></span> ",
        "add" : " <span class='glyphicon glyphicon-plus'></span> ",
        "save" : " <span class='glyphicon glyphicon-saved'></span> ",
        "confirm" : " <span class='glyphicon glyphicon-ok'></span> ",
        "operatePos" : -1,
        "editableCols" : [2,3,4],
        "order": ["add","edit"],
        "saveCallback" : function(data, isSuccess) {
            var flag = true;
            if(flag) {
                isSuccess();
                alert(data + " 保存成功");
            } else {
                alert(data + " 保存失敗");
            }
            return true;
        },
        "addCallback" : function(data,isSuccess) {
            var flag = true;
            if(flag) {
                isSuccess();
                alert(data + " 增加成功");
            } else {
                alert(data + " 增加失敗");
            }
        },
        "delCallback" : function(isSuccess) {
            var flag = true;
            if(flag) {
                isSuccess();
                alert("刪除成功");
            } else {
                alert("刪除失敗");
            }
        }
    });
});
</script>
</body>
</html>

執行結果如下:

使用編輯操作,進行修改:

點擊保存:

一次新增多行:

填入一些資料:

點擊「確定」:

多新增的空白列可以用取消鈕移除:

想 further 深入的話,可以再搭配 Bootstrap 學習教程、Bootstrap 實戰教程、Bootstrap 插件使用教程這三個專題一起看。

以上就是本文的全部內容,希望對大家的學習有所幫助。

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