Bootstrap Table 是一個體積很小的表格外掛,透過 AJAX 取得 JSON 就能完成資料渲染,分頁、排序、搜尋都內建,而且支援國際化。本文把實際做後台表格時的幾個關鍵設定整理出來。
可以直接從 CDN 取用樣式、外掛與中文語系檔,也可以下載到專案內。把這三行放進 head 即可開始使用:
<!-- 樣式 --> <link href="https://cdn.bootcss.com/bootstrap-table/1.9.1/bootstrap-table.min.css" rel="stylesheet"/> <script src="https://cdn.bootcss.com/bootstrap-table/1.9.1/bootstrap-table.min.js"></script> <!-- 中文語系 --> <script src="https://cdn.bootcss.com/bootstrap-table/1.9.1/locale/bootstrap-table-zh-CN.min.js"></script>
一種是直接在標籤上用 data-url 指定資料來源:
<table data-toggle="table" data-url="data.json"> <thead> ... </thead> </table>
另一種是在 JavaScript 初始化時傳入 url:
$('#table').bootstrapTable({ url: 'data.json' });
處理欄位較多、需要客製格式的情況,第二種方式彈性大得多,實務上幾乎都用它。
var $table = $('#table');
$table.bootstrapTable({
url: "duoBaoActivityList",
dataType: "json",
pagination: true, // 開啟分頁
singleSelect: false,
"data-locale": "zh-CN", // 中文
search: true, // 顯示搜尋框
sidePagination: "server",// 由伺服器處理分頁
columns: [
{ title: '活動名稱', field: 'name', align: 'center', valign: 'middle' },
{ title: '狀態', field: 'status', align: 'center', valign: 'middle' },
{ title: '參與人數', field: 'participationCounts', align: 'center' },
{ title: '總人數', field: 'totalCounts', align: 'center' },
{ title: '開始時間', field: 'startTime', align: 'center' },
{ title: '操作', field: 'id', align: 'center', formatter: function(value, row, index){
var e = '<a href="#" onclick="edit(\''+ row.id + '\')">編輯</a> ';
var d = '<a href="#" onclick="del(\''+ row.id +'\')">刪除</a> ';
return e + d;
}
}
]
});
要特別注意:field 名稱必須與後端回傳的 JSON 鍵值完全一致,否則欄位會一片空白,這是初學時最常卡住的地方。
開啟伺服器端分頁後,前端會送出兩個參數:limit(每頁筆數,預設 10)與 offset(位移量)。搜尋時則多帶一個 search 參數,值就是使用者輸入的關鍵字。
後端回應的 JSON 除了資料陣列,也必須包含 total(總筆數),前端才知道要畫出幾頁。把這兩個約定守住,分頁與搜尋就能無縫運作。
