Bootstrap Table 輕量、功能齊全,單選多選、排序分頁、欄位開關、固定表頭、響應式、AJAX 載入 JSON、卡片檢視一应俱全。前面兩篇談了基礎與進階擴充,這一篇收尾,把報表場景最常出現的四個需求一次講完。
訂單頁面很常見的需求:不同狀態的訂單用不同底色區隔。

點一下儲存格就能就地編輯,不必跳出視窗。




做報表時幾乎一定會遇到,尤其是跨欄的季度標題。

支援三種範圍:basic(目前頁)、all(全部)、selected(勾選列),格式則有 Excel、XML、JSON 等。
匯出目前頁:


匯出全部:


匯出勾選列:


其他格式與 Excel 的設定方式幾乎相同,就不再逐一示範。
自己用 jQuery 幫 tr 設背景色當然也行,但既然元件內建了機制,用官方 API 更省事,也比較不會跟元件的其他行為打架。
$('#tb_order').bootstrapTable({
url: '/TableStyle/GetOrder',
method: 'get',
striped: true,
cache: false,
pagination: true,
sortable: false,
sortOrder: "asc",
queryParams: oTableInit.queryParams,
sidePagination: "server",
pageNumber: 1,
pageSize: 10,
pageList: [10, 25, 50, 100],
search: true,
strictSearch: true,
showColumns: true,
showRefresh: true,
minimumCountColumns: 2,
clickToSelect: true,
height: 500,
uniqueId: "ID",
showToggle: true,
cardView: false,
detailView: false,
rowStyle: function (row, index) {
// 五個可選值對應五種顏色
// ['active', 'success', 'info', 'warning', 'danger']
var strclass = "";
if (row.ORDER_STATUS == "待排產") {
strclass = 'success';
} else if (row.ORDER_STATUS == "已刪除") {
strclass = 'danger';
} else {
return {};
}
return { classes: strclass };
},
columns: [
{ checkbox: true },
{ field: 'ORDER_NO', title: '訂單編號' },
{ field: 'ORDER_TYPE', title: '訂單類型' },
{ field: 'ORDER_STATUS', title: '訂單狀態' },
{ field: 'REMARK', title: '備註' }
]
});
核心就是 rowStyle 這段。回傳值必須是形如 { classes: strclass } 的物件——這點第一次用時很容易卡住,因為文件沒特別強調。五種顏色實際渲染出來的效果,把程式跑一次就一目了然。
引入擴充所需的 CSS 與 JS:
<link rel="stylesheet" href="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/css/bootstrap-editable.css"> <script src="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/js/bootstrap-editable.js"</script> <script src="~/Content/bootstrap-table/extensions/editable/bootstrap-table-editable.js"</script>
在表頭標記哪些欄位可編輯:
<table id="tb_departments">
<thead>
<tr>
<th data-field="Name" data-editable="true">部門名稱</th>
<th data-field="ParentName">上級部門</th>
<th data-field="Level" data-editable="true">部門級別</th>
<th data-field="Desc" data-editable="true">描述</th>
</tr>
</thead>
</table>
若改用 JS 定義欄位,寫成 { field: "name", title: "名稱", editable: true } 即可。
接著註冊儲存事件:
$('#tb_departments').bootstrapTable({
url: '/Editable/GetDepartment',
method: 'get',
toolbar: '#toolbar',
striped: true,
cache: false,
pagination: true,
sortable: false,
sortOrder: "asc",
queryParams: oTableInit.queryParams,
sidePagination: "server",
pageNumber: 1,
pageSize: 10,
onEditableSave: function (field, row, oldValue, $el) {
$.ajax({
type: "post",
url: "/Editable/Edit",
data: { strJson: JSON.stringify(row) },
success: function (data, status) {
if (status == "success") { alert("編輯成功"); }
},
error: function () { alert("Error"); }
});
}
});
四個參數分別是:欄位名稱、該列資料物件、修改前的值、目前儲存格的 jQuery 物件。保存邏輯要自己在回呼裡實作。
這個功能不需要任何額外 JS,直接用原生 table 屬性就能做到,只在表頭寫就好。
<table id="tb_report">
<thead>
<tr>
<th colspan="4" data-valign="middle" data-align="center">第一季</th>
<th colspan="4" data-valign="middle" data-align="center">第二季</th>
<th colspan="4" data-valign="middle" data-align="center">第三季</th>
<th colspan="4" data-valign="middle" data-align="center">第四季</th>
<th data-field="TotalCount" rowspan="2" data-valign="middle" data-align="center">年度匯總</th>
</tr>
<tr>
<th data-field="JanCount" data-align="center">一月</th>
<th data-field="FebCount" data-align="center">二月</th>
<th data-field="MarCount" data-align="center">三月</th>
<th data-field="FirstQuarter" data-align="center">第一季</th>
<th data-field="AprCount" data-align="center">四月</th>
<th data-field="MayCount" data-align="center">五月</th>
<th data-field="JunCount" data-align="center">六月</th>
<th data-field="SecondQuarter" data-align="center">第二季</th>
<th data-field="JulCount" data-align="center">七月</th>
<th data-field="AguCount" data-align="center">八月</th>
<th data-field="SepCount" data-align="center">九月</th>
<th data-field="ThirdQuarter" data-align="center">第三季</th>
<th data-field="OctCount" data-align="center">十月</th>
<th data-field="NovCount" data-align="center">十一月</th>
<th data-field="DecCount" data-align="center">十二月</th>
<th data-field="ForthQuarter" data-align="center">第四季</th>
</tr>
</thead>
</table>
JS 初始化不需要任何特殊設定:
$('#tb_report').bootstrapTable({
url: '/GroupColumns/GetReport',
method: 'get',
toolbar: '#toolbar',
striped: true,
cache: false,
pagination: true,
sortOrder: "asc",
queryParams: oTableInit.queryParams,
sidePagination: "server",
pageNumber: 1,
pageSize: 10,
pageList: [10, 25, 50, 100]
});
其實連 JS 都可以省——查一下 API 會發現每個初始化參數都有對應的 table 屬性,只要沒有特殊事件要處理,純 HTML 宣告就足夠。
<script src="~/Content/bootstrap-table/extensions/export/bootstrap-table-export.js"</script> <script src="//rawgit.com/hhurz/tableExport.jquery.plugin/master/tableExport.js"</script>
$('#tb_departments').bootstrapTable({
url: '/Export/GetDepartment',
method: 'get',
toolbar: '#toolbar',
striped: true,
cache: false,
pagination: true,
sortable: false,
sortOrder: "asc",
queryParams: oTableInit.queryParams,
sidePagination: "client",
pageNumber: 1,
pageSize: 10,
pageList: [10, 25, 50, 100],
clickToSelect: true,
showExport: true, // 是否顯示匯出按鈕
exportDataType: "basic", // 'basic' | 'all' | 'selected'
columns: [
{ checkbox: true },
{ field: 'Name', title: '部門名稱' },
{ field: 'ParentName', title: '上級部門' },
{ field: 'Level', title: '部門級別' },
{ field: 'Desc', title: '描述' }
]
});
要動的只有 showExport 與 exportDataType 這兩行。
1. 行內編輯的請求粒度。目前是每個儲存格各自 POST 一次,一次編輯多格就會產生多次資料庫寫入。理想上應該改成整列一起送出,但元件沒有現成支援,需要自己攔下編輯事件累積成批次。
2. 匯出的瀏覽器相容性。這個擴充在 IE 上無法運作,用官方範例頁實測同樣匯不出來。若專案還需要支援 IE,匯出得另外找方案或直接在後端產檔。
以上就是 Bootstrap Table 系列的三篇內容。從基礎綁定一路到報表級的客製化,這個元件的表現確實稱得上「表格神器」。