Bootstrap Table 是個輕量而功能密度極高的表格元件,單選、多選、排序、分頁、欄位顯示切換、固定表頭捲動、響應式版面、AJAX 載入 JSON、卡片檢視樣樣都有。本篇跳過入門,直接談三個實務上很常被要求、文件中卻得翻半天才找到的功能:父子表、拖曳排序、以及每個欄位各自的篩選框。



排序前:

把某一列拖到最前面:




原理其實很單純。初始化時把 detailView 設為 true,每一列前面就會出現「+」號,點它就觸發展開事件,我們在事件裡把子表格塞進去。
$("#tb_powerset").bootstrapTable({
url: '/api/MenuApi/GetParentMenu',
method: 'get',
detailView: true, // 開啟父子表
pageSize: 10,
pageList: [10, 25],
columns: [
{ field: 'MENU_NAME', title: '菜單名稱' },
{ field: 'MENU_URL', title: '菜單網址' },
{ field: 'PARENT_ID', title: '父級菜單' },
{ field: 'MENU_LEVEL', title: '菜單級別' }
],
onExpandRow: function (index, row, $detail) {
oInit.InitSubTable(index, row, $detail);
}
});
展開事件的回呼有三個參數,其中第三個最關鍵:
index:父表目前這列的索引。row:父表目前這列的 JSON 資料。$detail:展開後新增那一列裡的 td 元素——子表格就是要掛在它裡面。
oInit.InitSubTable = function (index, row, $detail) {
var parentid = row.MENU_ID;
var cur_table = $detail.html('<table></table>').find('table');
$(cur_table).bootstrapTable({
url: '/api/MenuApi/GetChildrenMenu',
method: 'get',
queryParams: { strParentID: parentid },
ajaxOptions: { strParentID: parentid },
clickToSelect: true,
detailView: true, // 子表也開父子表,就能無限層級
uniqueId: "MENU_ID",
pageSize: 10,
pageList: [10, 25],
columns: [
{ checkbox: true },
{ field: 'MENU_NAME', title: '菜單名稱' },
{ field: 'MENU_URL', title: '菜單網址' },
{ field: 'PARENT_ID', title: '父級菜單' },
{ field: 'MENU_LEVEL', title: '菜單級別' }
],
onExpandRow: function (i, r, $Subdetail) {
oInit.InitSubTable(i, r, $Subdetail); // 遞迴下去
}
});
};
重點就兩個:用 $detail.html('<table></table>') 生出一個空表格,再對它呼叫 bootstrapTable()。因為子表也開了 detailView 並遞迴呼叫自己, theoretically 可以有無限層級的展開。
額外引入兩個檔案:
<script src="~/Content/jquery-ui-1.11.4.custom/external/jquery.tablednd.js"></script> <script src="~/Content/bootstrap-table/extensions/reorder-rows/bootstrap-table-reorder-rows.js"></script>
表格標籤上加兩個屬性:
<table id="tb_order" data-use-row-attr-func="true" data-reorderable-rows="true"></table>
JavaScript 初始化完全不用改,功能就有了。
需要引入的資源多了一些:
<script src="~/Content/bootstrap-table/extensions/reorder-columns/bootstrap-table-reorder-columns.js"></script> <link rel="stylesheet" href="../assets/examples.css"> <link rel="stylesheet" href="https://rawgit.com/akottr/dragtable/master/dragtable.css"> <script src="https://code.jquery.com/ui/1.11.4/jquery-ui.js"</script> <script src="https://rawgit.com/akottr/dragtable/master/jquery.dragtable.js"</script>
標籤上加一個屬性即可:
<table id="tb_departments" data-reorderable-columns="true"</table>
原本以為這種逐欄篩選只支援前端分頁,查了文件才發現確實有現成擴充,而且篩選條件會一起送到後端。




引入擴充:
<script src="~/Content/bootstrap-table/extensions/filter-control/bootstrap-table-filter-control.js"</script>
在表頭直接宣告篩選控件型態,select 是下拉清單,input 是文字框:
<table id="tb_roles" data-filter-control="true">
<thead>
<tr>
<th data-field="ROLE_NAME" data-filter-control="select">角色名稱</th>
<th data-field="DESCRIPTION" data-filter-control="input">角色描述</th>
<th data-field="ROLE_DEFAULTURL" data-filter-control="input">角色預設頁</th>
</tr>
</thead>
</table>
因為欄位定義已經寫在表頭,JS 初始化時就不用再寫 columns:
$('#tb_roles').bootstrapTable({
url: '/Role/GetRole',
method: 'get',
toolbar: '#toolbar',
striped: true,
cache: false,
pagination: true,
sortable: true,
queryParams: function (param) { return param; },
queryParamsType: "limit",
detailView: false,
sidePagination: "server",
pageSize: 10,
pageList: [10, 25, 50, 100],
search: true,
showColumns: true,
showRefresh: true,
minimumCountColumns: 2,
clickToSelect: true
});
實際打開開發者工具追一次請求就會看到,篩選條件被序列化進 query string 一起送到後端:

後端接收到參數後反序列化即可使用:

這樣就不必自己擴充搜尋功能了,尤其在服務端分頁的情境下特別省事。
Bootstrap Table 能玩的当然不会只有這些,像是列的合併、欄位的凍結等進階應用,就留待後續再補。以上三個功能都是實務案的常客,把範例跑通之後,照著換成自己的 API 就能用。