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() 即可。