下面把 bootstrap-table 的用法梳理一遍,重點放在配置項含義和與後端分頁的對接上。
項目地址:https://github.com/wenzhixin/bootstrap-table
<link rel="stylesheet" href="../bower_components/bootstrap/dist/css/bootstrap.min.css"/> <link rel="stylesheet" href="../bower_components/bootstrap-table-develop/dist/bootstrap-table.min.css"/> <script type="text/javascript" src="../bower_components/jquery/dist/jquery.min.js"></script> <script type="text/javascript" src="../bower_components/bootstrap/dist/js/bootstrap.min.js"></script> <script type="text/javascript" src="../bower_components/bootstrap-table-develop/dist/bootstrap-table.js"></script> <script type="text/javascript" src="../bower_components/bootstrap-table-develop/dist/locale/bootstrap-table-zh-CN.js"></script>
聲明式,直接寫在 table 標籤上:
<table data-toggle="table" data-url="data.json"> <thead> ... </thead> </table>
或者調用式:
<table id="table" class="mychar1-table"></table>
$('#table').bootstrapTable({ url: 'data.json' });
var $table = $('#mychart1');
$table.bootstrapTable({
url: reqprojectname_w + 'list/spectrumlist',
dataType: "json",
toolbar: '#toolbar', //工具按鈕用哪個容器
striped: true, //是否顯示行間隔色
singleSelect: false,
pagination: true, //分頁
pageNumber: 1, //初始化加載第一頁
pageSize: 10, //每頁記錄行數
pageList: [10, 25, 50, 100], //可選的每頁行數
search: false, //是否顯示搜索框
sidePagination: "server", //服務端分頁
columns: [
{ field: 'id', title: '序號' },
{ field: 'liushuiid', title: '交易編號' },
{ field: 'orderid', title: '訂單號' },
{ field: 'receivetime', title: '交易時間' },
{ field: 'price', title: '金額' },
{ field: 'coin_credit', title: '投入硬幣' },
{ field: 'bill_credit', title: '投入紙幣' },
{ field: 'changes', title: '找零' },
{ field: 'tradetype', title: '交易類型' },
{ field: 'goodmachineid', title: '貨機號' },
{ field: 'inneridname', title: '貨道號' },
{ field: 'goodsName', title: '商品名稱' },
{ field: 'changestatus', title: '支付' },
{ field: 'sendstatus', title: '出貨' },
{
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;
}
}
]
});
$(function () {
//1.初始化 Table
var oTable = new TableInit();
oTable.Init();
});
var TableInit = function () {
var oTableInit = new Object();
oTableInit.Init = function () {
$('#tradeList').bootstrapTable({
url: '/VenderManager/TradeList', //請求後台的 URL
method: 'post', //請求方式
toolbar: '#toolbar',
striped: true, //是否顯示行間隔色
cache: false, //關閉緩存,默認是 true,一般需要改
pagination: true, //是否顯示分頁
sortable: false,
sortOrder: "asc",
queryParams: oTableInit.queryParams, //傳遞參數
sidePagination: "server", //client 客戶端 / 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: 'coin_credit', title: '投入硬幣' },
{ field: 'bill_credit', title: '投入紙幣' },
{ field: 'changes', title: '找零' },
{ field: 'tradetype', title: '交易類型' },
{ field: 'goodmachineid', title: '貨機號' },
{ field: 'inneridname', title: '貨道號' },
{ field: 'goodsName', title: '商品名稱' },
{ field: 'changestatus', title: '支付' },
{ field: 'sendstatus', title: '出貨' }
]
});
};
//自定義查詢參數,鍵名必須和後端變量名一致
oTableInit.queryParams = function (params) {
return {
limit: params.limit, //頁面大小
offset: params.offset, //偏移量
sdate: $("#stratTime").val(),
edate: $("#endTime").val(),
sellerid: $("#sellerid").val(),
orderid: $("#orderid").val(),
maxrows: params.limit,
pageindex: params.pageNumber,
portid: $("#portid").val(),
CardNumber: $("#CardNumber").val(),
tradetype: $('input:radio[name="tradetype"]:checked').val(),
success: $('input:radio[name="success"]:checked').val()
};
};
return oTableInit;
};
分頁請求時,bootstrap-table 會主動帶上兩個字段:limit(每頁條數,默認 10)和 offset(數據偏移量);開啟搜索後還會多一個 search 字段,值是搜索框裡的內容。
響應數據必須包含 rows(當前頁的數據數組)和 total(總記錄數),前端依賴這兩個字段完成分頁渲染。
後端拼接測試數據的示例:
JSONArray jsonData = new JSONArray();
JSONObject jo = null;
for (int i = 0, len = 10; i < len; i++) {
jo = new JSONObject();
jo.put("id", i + (j++));
jo.put("liushuiid", i + 1);
jo.put("price", 100);
jo.put("receivetime", 10);
jo.put("tradetype", 10);
jo.put("changestatus", "成功");
jo.put("sendstatus", "失敗");
jo.put("orderid", 10);
jo.put("goodsName", 10);
jo.put("inneridname", 10);
jsonData.add(jo);
}
int TotalCount = 97;
JSONObject jsonObject = new JSONObject();
jsonObject.put("rows", jsonData); //JSONArray
jsonObject.put("total", TotalCount); //總記錄數
後端解析分頁參數並換算頁碼:
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; //實際頁碼
記住這組約定——前端傳 limit / offset / search,後端回 rows / total——對接基本就不會出問題。