Bootstrap-Table 是一個 Bootstrap 的表格外掛,能把 JSON 數據直接顯示在表格中。當然,這需要先配置一些參數並初始化表格才行。其官網為:https://bootstrap-table.wenzhixin.net.cn/,裡面可下載所需的 JS 與 CSS 檔案,也能參考文件與範例。
Bootstrap-Table 把數據顯示到表格的方式有兩種:一種是客戶端(client)模式,一種是伺服器(server)模式。
所謂客戶端模式,指的是在伺服器端把要顯示的數據一次性加載出來,轉換成 JSON 格式傳到界面;在 JavaWeb 中可先存進 request,再轉發到指定頁面,於初始化時用 EL 表達式取出,然後呼叫相關初始化函式,把 JSON 字串傳進去即可顯示。客戶端模式較簡單,它一次把數據加載到頁面上,再依你設定的每頁筆數自動生成分頁。當你點擊第二頁時,它會直接從已載入的數據中顯示,不會再向伺服器發送請求;同時使用者還能用其內建的搜尋功能進行「全數據」搜尋。數據量小的時候,這方法很合適;但對於數據龐大的系統,它會把一些很久以前、使用者早已不再關注的數據也一併載入,拖慢加載速度、加重伺服器負擔、浪費資源——這時就該改用伺服器模式。
所謂伺服器模式,則是根據設定的每頁筆數與當前頁碼,把請求發送到伺服器進行查詢,再把結果顯示到表格中。它能依使用者需要動態加載數據,節省伺服器資源;但代價是無法使用其內建的「全數據搜尋」——因為你手上只有當前這一頁的數據,搜尋範圍自然也只限於這一頁。
客戶端模式較簡單,讀者可依官方文件與範例自行實作,這裡主要介紹伺服器模式,並可實現帶參數的查詢。
系統界面如下圖:

上圖是用 Bootstrap-Table 實作的一個界面,附帶一個輸入框與查詢按鈕。在輸入框輸入單號並點擊查詢,就會到後台查詢,再把結果顯示到表格中。由於資料庫中數據較少,為了看效果,這裡每頁只設定顯示一筆。以下是前端界面程式碼:
首先引入相應的 JS 與 CSS 檔案,定義一個表格標籤並配置相關的 bootstrap-table 屬性(此處省略了欄位的程式碼)。
<link href="css/bootstrap.min.css" rel="stylesheet" type="text/css"> <link href="css/bootstrap-table.min.css" rel="stylesheet" type="text/css"> <script src="js/jquery.min.js"></script> <script src="js/bootstrap.min.js"></script> <script src="js/plugins/bootstrap-table.min.js"></script> <script src="js/plugins/bootstrap-table-zh-CN.js"></script> <table class="table table-hover" id="cusTable" data-pagination="true" data-show-refresh="true" data-show-toggle="true" data-showColumns="true"> <thead> <tr> <th data-field="sellRecordId" data-sortable="true"> 銷售記錄id </th> <th data-field="srNumber" > 銷售單號 </th> <!-- 在此省略表格列的代碼,代碼和上面差不多 --> <th class="col-xs-2" data-field="action" data-formatter="actionFormatter" data-events="actionEvents">Action</th> </tr> </thead> <tbody> </tbody> </table>
以下是 JavaScript 程式碼:定義了一個 initTable() 函式用於初始化表格。第 7 行的 method 指定請求的提交方式(我原本嘗試設成 post,卻發現後端取不到查詢參數,原因不明,於是改用 get)。第 8 行的 url 設定要提交請求的位址。第 17 行指定以伺服器端模式加載數據。第 20 行指定查詢參數的類型,可設為 undefined 或 limit,不同設定會讓 queryParams 函式取得不同參數。第 23-25 行分別取得頁碼、每頁筆數、查詢條件並作為參數回傳;這裡只有一個條件,若要多條件查詢,再多取幾個即可。第 40 行在 ready 中呼叫函式,把後端數據顯示到表格。第 43 行則為查詢按鈕綁定單擊事件。由於查詢是在首次加載表格之後才有的動作,所以第 4 行要先呼叫 bootstrap-table 提供的函式「銷毀」表格,否則點擊查詢時無法到後台重新加載數據。
<script type="text/javascript"> function initTable() { //先銷毀表格 $('#cusTable').bootstrapTable('destroy'); //初始化表格,動態從服務器加載數據 $("#cusTable").bootstrapTable({ method: "get", //使用get請求到服務器獲取數據 url: "<c:url value='/SellServlet?act=ajaxGetSellRecord'/>", //獲取數據的Servlet地址 striped: true, //表格顯示條紋 pagination: true, //啟動分頁 pageSize: 1, //每頁顯示的記錄數 pageNumber:1, //當前第幾頁 pageList: [5, 10, 15, 20, 25], //記錄數可選列表 search: false, //是否啟用查詢 showColumns: true, //顯示下拉框勾選要顯示的列 showRefresh: true, //顯示刷新按鈕 sidePagination: "server", //表示服務端請求 //設置為undefined可以獲取pageNumber,pageSize,searchText,sortName,sortOrder //設置為limit可以獲取limit, offset, search, sort, order queryParamsType : "undefined", queryParams: function queryParams(params) { //設置查詢參數 var param = { pageNumber: params.pageNumber, pageSize: params.pageSize, orderNum : $("#orderNum").val() }; return param; }, onLoadSuccess: function(){ //加載成功時執行 layer.msg("加載成功"); }, onLoadError: function(){ //加載失敗時執行 layer.msg("加載數據失敗", {time : 1500, icon : 2}); } }); } $(document).ready(function () { //調用函數,初始化表格 initTable(); //當點擊查詢按鈕的時候執行 $("#search").bind("click", initTable); }); </script> 後端 servlet 程式碼:
在 servlet 中取得 act 參數後,呼叫如下程式碼,接著呼叫 service 業務邏輯進行查找。service 中會判斷 orderNum 是否為空字串:若為空則不帶 orderNum 查詢,不為空則帶上該條件查詢;service 再呼叫 dao,dao 裡的函式同樣要依 orderNum 是否為空而生成不同的 SQL 與查詢參數。第 23 行把查詢記錄轉成 JSON 字串,第 25 行取得符合條件的總記錄數。注意第 28 行設定了回傳給前端的 JSON,這裡需要回傳兩個參數:total(總記錄數)與 rows(表格數據)。
/** * 根據頁碼和每頁記錄數,以及查詢條件動態加載銷售記錄 * @param request * @param response * @throws IOException * @author lzx */ private void ajaxGetSellRecord(HttpServletRequest request, HttpServletResponse response) throws IOException { response.setCharacterEncoding("utf-8"); PrintWriter pw = response.getWriter(); //得到客戶端傳遞的頁碼和每頁記錄數,並轉換成int類型 int pageSize = Integer.parseInt(request.getParameter("pageSize")); int pageNumber = Integer.parseInt(request.getParameter("pageNumber")); String orderNum = request.getParameter("orderNum"); //分頁查找商品銷售記錄,需判斷是否有帶查詢條件 List<SimsSellRecord> sellRecordList = null; sellRecordList = sellRecordService.querySellRecordByPage(pageNumber, pageSize, orderNum); //將商品銷售記錄轉換成json字符串 String sellRecordJson = sellRecordService.getSellRecordJson(sellRecordList); //得到總記錄數 int total = sellRecordService.countSellRecord(orderNum); //需要返回的數據有總記錄數和行數據 String json = "{\"total\":" + total + ",\"rows\":" + sellRecordJson + "}"; pw.print(json); }