DIV CSS 佈局教程網

Bootstrap Table 表格元件詳解(進階篇)
編輯:關於JavaScript     

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

一、引入方式

基本上有兩條路:

  1. 下載原始碼放進專案。由於它是 Bootstrap 的元件,必須先引入 Bootstrap 本體(CSS 與 JS)以及 jQuery。
  2. 透過 NuGet 安裝。搜尋套件後直接安裝即可,Bootstrap 通常已是 3.3.5 以上的版本。

不過套件庫裡的 Bootstrap Table 版本往往落後官方很多(套件可能還停在 0.4,官方已來到 1.9.x),所以建議表格本體直接到官方下載最新版。

專案背景

近期客戶希望把既有的管理系統改造成手機也能順利使用,評估了兩個方向:

  • A 案:保留原頁面,另外做一套行動版,手機連到 m 站台、PC 連到 www 站台。
  • B 案:導入 Bootstrap 框架改寫頁面,讓同一套畫面自動適配手機、平板與桌機。

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,記得實際測一遍表格元件的呈現結果。

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