Bootstrap Table 是目前後台系統裡相當實用的一套表格元件:輕量、以 AJAX 抓 JSON 填充資料、分頁與排序內建、支援國際化。本文從引入方式一路談到後端資料格式與分頁參數,把實際專案會遇到的環節都走過一遍。
基本上有兩條路:


不過套件庫裡的 Bootstrap Table 版本往往落後官方很多(套件可能還停在 0.4,官方已來到 1.9.x),所以建議表格本體直接到官方下載最新版。
近期客戶希望把既有的管理系統改造成手機也能順利使用,評估了兩個方向:
A 案等於要做兩套介面與兩套 API,時間與成本都高,最後專案採用了 B 案。

<!-- css --> <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet"> <link href="css/bootstrap/bootstrap-table.css" rel="stylesheet"> <!-- js --> <script src="js/bootstrap/jquery-1.12.0.min.js" type="text/javascript"></script> <script src="js/bootstrap/bootstrap.min.js"></script> <script src="js/bootstrap/bootstrap-table.js"></script> <script src="js/bootstrap/bootstrap-table-zh-CN.js"></script>
取得資料有兩種方式:在 table 標籤上用 data-url,或在 JavaScript 初始化時指定 url。處理複雜資料時第二種方式更靈活。
$('#tradeList').bootstrapTable({
url: '/VenderManager/TradeList', // 後台網址
method: 'post',
toolbar: '#toolbar',
striped: true, // 斑馬線
cache: false, // 關閉快取
pagination: true, // 開啟分頁
sortable: false,
sortOrder: "asc",
queryParams: oTableInit.queryParams, // 自訂傳入參數
sidePagination: "server",// 伺服器端分頁
pageNumber: 1,
pageSize: 50,
pageList: [10, 25, 50, 100],
strictSearch: true,
clickToSelect: true,
height: 460,
uniqueId: "id",
cardView: false,
detailView: false,
columns: [
{ field: 'id', title: '序號' },
{ field: 'liushuiid', title: '交易編號' },
{ field: 'orderid', title: '訂單號' },
{ field: 'receivetime', title: '交易時間' },
{ field: 'price', title: '金額' },
{ field: 'tradetype', title: '交易類型' },
{ field: 'changestatus', title: '支付' },
{ field: 'sendstatus', title: '出貨' }
]
});
要加上自訂的查詢條件時,透過 queryParams 掛上:
oTableInit.queryParams = function (params) {
var temp = {
limit: params.limit, // 每頁筆數
offset: params.offset, // 位移量
sdate: $("#stratTime").val(),
edate: $("#endTime").val(),
sellerid: $("#sellerid").val(),
orderid: $("#orderid").val(),
tradetype: $('input:radio[name="tradetype"]:checked').val(),
maxrows: params.limit,
pageindex: params.pageNumber
};
return temp;
};
再次強調:field 必須與後端回傳的鍵名一致,否則欄位空白。
使用伺服器端分頁時,回應的 JSON 一定要包含 rows(資料陣列)與 total(總筆數)兩個鍵:
gblst = SqlADO.getTradeList(sql, pageindex, maxrows);
JSONArray jsonData = new JSONArray();
JSONObject jo = null;
for (int i = 0, len = gblst.size(); i < len; i++) {
TradeBean tb = gblst.get(i);
if (tb == null) continue;
jo = new JSONObject();
jo.put("id", i + 1);
jo.put("liushuiid", tb.getLiushuiid());
jo.put("price", String.format("%1.2f", tb.getPrice() / 100.0));
jo.put("receivetime", ToolBox.getYMDHMS(tb.getReceivetime()));
jo.put("changestatus", (tb.getChangestatus() != 0) ? "成功" : "失敗");
jo.put("sendstatus", (tb.getSendstatus() != 0) ? "成功" : "失敗");
jsonData.add(jo);
}
int TotalCount = SqlADO.getTradeRowsCount(sql);
JSONObject jsonObject = new JSONObject();
jsonObject.put("rows", jsonData);
jsonObject.put("total", TotalCount);
out.print(jsonObject.toString());
後端若用 Spring MVC,方法簽名直接把前端參數列出即可:
public JsonResult GetDepartment(int limit, int offset, string orderId,
string SellerId, string PortId,
string CardNumber, string Success,
int maxrows, string tradetype) { ... }

int pageindex = 0;
int offset = ToolBox.filterInt(json1.getString("offset"));
int limit = ToolBox.filterInt(json1.getString("limit"));
if (offset != 0) { pageindex = offset / limit; }
pageindex += 1; // 轉成從 1 開始的頁碼
把 offset 換算回頁碼時別忘了 +1,這是常見的 off-by-one 陷阱。
Bootstrap 3 本身已能在 IE8 上運作(需搭配 respond.js 與 html5shiv)。若專案仍需支援舊版 IE,記得實際測一遍表格元件的呈現結果。