DIV CSS 佈局教程網

Bootstrap Table 使用教學:從引入到後端分頁的完整設定
編輯:關於JavaScript     

bootstrap-table 是我做後台表格時的首選之一,排序、分頁、勾選、欄位切換這些常見需求它都現成具備,設定方式也很直觀。

先準備依賴

需要的檔案有 jQuery、bootstrap 本體、bootstrap-table 的 CSS 與 JS,以及中文語言包:

 <!-- bootstrap table -->
<script type="text/javascript" src="${pageContext.request.contextPath}/res/jquery-1.10.2/jquery.js"></script>
<!-- bootstrap -->
<link rel="stylesheet" type="text/css" href="${pageContext.request.contextPath}/res/bootstrap/css/bootstrap.css"/>
<script type="text/javascript" src="${pageContext.request.contextPath}/res/bootstrap/js/bootstrap.js"></script>
<link rel="stylesheet" type="text/css" href="${pageContext.request.contextPath}/res/bootstrap-table/bootstrap-table.css"/>
<script type="text/javascript" src="${pageContext.request.contextPath}/res/bootstrap-table/bootstrap-table.js"></script>
<!-- bootstrap table中文包 -->
<script type="text/javascript" src="${pageContext.request.contextPath}/res/bootstrap-table/locale/bootstrap-table-zh-CN.js"></script>

中文語言包除了把分頁文字漢化,也順帶避開了某些顯示上的疑難雜症,建議一定要帶。

如果你只零散引入上面幾個檔案導致樣式跑掉,最省事的解法是直接下載完整的 bootstrap-table 發行包,把 dist 目錄整包放進專案。

初始化表格

寫法上我習慣包一層 TableInit,把初始化與參數查詢分開管理,後面要擴充比較清爽:

 <script type="text/javascript">
$(function () {
  //1.初始化Table
  var oTable = new TableInit();
  oTable.Init();
});
var TableInit = function () {
  var oTableInit = new Object();
  oTableInit.Init = function () {
    $('#tb_departments').bootstrapTable({
      url: '${pageContext.request.contextPath}/AlarmInfo/list', //請求後台的URL(*)
      method: 'get',                     //請求方式(*)
      toolbar: '#toolbar',               //工具按鈕用哪個容器
      striped: false,                    //是否顯示行間隔色
      cache: false,                      //是否使用緩存(*)
      pagination: true,                  //是否顯示分頁(*)
      sortable: false,                   //是否啟用排序
      sortOrder: "asc",                  //排序方式
      queryParams: oTableInit.queryParams,//傳遞參數(*)
      sidePagination: "server",          //client客戶端分頁,server服務端分頁(*)
      pageNumber: 1,                     //初始化加載第一頁
      pageSize: 10,                      //每頁的記錄行數(*)
      pageList: [10, 25, 50, 100],       //可供選擇的每頁行數(*)
      search: false,                     //是否顯示搜索框(僅前端過濾)
      strictSearch: true,
      showColumns: true,                 //是否顯示所有列的切換
      showRefresh: false,                //是否顯示刷新按鈕
      minimumCountColumns: 2,            //最少允許顯示的列數
      clickToSelect: true,               //是否啟用點擊選中行
      height: 500,                       //表格高度
      uniqueId: "id",                    //每一行的唯一標識
      showToggle: true,                  //卡片視圖/列表視圖切換
      cardView: true,                    //是否顯示詳細視圖
      detailView: false,                 //是否顯示父子表
      columns: [
        { checkbox: true },
        { field: 'Id',   title: '編號' },
        { field: 'Name', title: '姓名' },
        { field: 'Type', title: '類型' },
        { field: 'Time', title: '時間' }
      ]
    });
  };
</script>

<table id="tb_departments"></table>

幾個實務上容易踩到的設定

sidePagination 是最關鍵的一項。設成 client 時,插件會一次把全部資料抓回來在前端切片,資料量大就會卡;設成 server 時則由後端處理 limit/offset,同時 total 欄位必須回傳,否則分頁頁碼會算錯。

search: true 看起來很方便,但它只是前端過濾。搭配 server 分頁時,它只會在你目前已載入的那一頁裡搜尋,很容易讓人以為「搜不到」。真正的全量搜尋要自己在工具列放輸入框,透過 queryParams 把關鍵字送進後端。

cache: false 建議開著。預設為 true 時,IE 一類瀏覽器會快取 GET 請求,導致查詢條件改了但畫面沒變,這是相當常見的疑惑來源。

uniqueId 記得填主鍵。後續要取得勾選列、做批次操作或行更新時,都得靠它來定位。

最後補充取值的用法:勾選列可用 $('#tb_departments').bootstrapTable('getSelections');要刷新並重查則呼叫 refresh({pageNumber:1});單純重載當前頁用 refresh() 即可。

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