本文要分享的是一個自己寫的 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 相同,只是分別用在新增與刪除這兩個動作上。
/**
* 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 插件使用教程這三個專題一起看。
以上就是本文的全部內容,希望對大家的學習有所幫助。