先看 Bootstrap Table 的應用效果:

表格用來展示數據庫中的數據,數據通過 AJAX 從服務端加載,分頁也由服務端實現,以避免客戶端分頁在加載大量數據時造成的不良體驗。同時支持設置查詢的起止時間,查詢指定時間範圍內的數據。在線編輯功能則通過擴展 Bootstrap Table、借助 X-editable 實現。
Bootstrap Table 有兩種使用方式:
1. 對普通的 table 設置 data 屬性;
2. 通過 JavaScript 啟用 Bootstrap Table 插件。
第一種很方便,但我更傾向第二種,它能做到 JS 與 HTML 分離,且 JS 代碼可復用。Bootstrap Table 文檔較為詳細,但部分具體內容仍需參考示例代碼。
先貼出前台與後台的實現代碼,再逐一說明。
前台需要的資源文件,主要有 Bootstrap3 相關樣式、js,以及 bootstrap Table 相關 css、js 和基於 Bootstrap3 的 X-editable 樣式、js:
<link rel="stylesheet" href="../assets/bootstrap/css/bootstrap.min.css"> <link rel="stylesheet" href="../assets/bootstrap-table/src/bootstrap-table.css"> <link rel="stylesheet" href="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/css/bootstrap-editable.css"> <script src="../assets/jquery.min.js"></script> <script src="../assets/bootstrap/js/bootstrap.min.js"></script> <script src="../assets/bootstrap-table/src/bootstrap-table.js"></script> <script src="../assets/bootstrap-table/src/extensions/editable/bootstrap-table-editable.js"></script> <script src="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/js/bootstrap-editable.js"></script>
HTML 代碼只需:
<table id="querylist" class="table table-striped"></table>
JS 代碼(時間查詢相關):查詢時間設置正確後,通過 bootstrap Table 的 refresh 方法重新加載數據。
$('#submitgetdata').click(function () { $('#msg').html(''); var begintime_ = $('#begintime').val(); var endtime_ = $('#endtime').val(); var err = ''; if (begintime_ == '' || endtime_ == ''){ err = '查詢時間不能為空'; }else if(Date.parse(endtime_)-Date.parse(begintime_) < 0){ err = '查詢時間設置錯誤'; } if (err) { $('#msg').html(err + '!'); $('#msg').fadeIn(1000); } else { $('#msg').html("正在提交!"); $('#querylist').bootstrapTable('refresh'); $('#msg').fadeOut(3000); } });
Table 相關 js:
$('#querylist').bootstrapTable({ columns: [{ field: 'MeterMeasureHistoryID', title: 'ID', sortable: true }, { field: 'Value', title: '值', editable: { type: 'text', validate: function(value) { if($.trim(value) == '') { return '測量值不能為空'; } } } }, { field: 'Timestamp', title: '時間', editable: { type: 'text', validate: function(value) { if($.trim(value) == '') { return '時間不能為空'; }else if(!Date.parse(value)){ return '時間設置錯誤'; } } } },{ field: 'operation', title: '操作', formatter:function(value,row,index){ var s = '<a class = "save" href="javascript:void(0)">保存</a>'; var d = '<a class = "remove" href="javascript:void(0)">刪除</a>'; return s+' '+d; }, events: 'operateEvents' }], sortName: 'MeterMeasureHistoryID', sortOrder: 'desc', pagination: true, sidePagination: 'server', pageNumber: 1, pageSize: 5, pageList: [5, 10, 20], queryParams: function (params) { return { meterID: $('#meterid').val(), pageSize: params.limit, offset: params.offset, sortOrder: params.order, begintime: $('#begintime').val(), endtime: $('#endtime').val() } }, url: '/Analyze/GetJsonHistoryDatas' }); window.operateEvents = { 'click .save': function (e, value, row, index) { $.ajax({ type: "post", data: row, url: '/Analyze/EditMeterMeasureHistoryData', success: function (data) { alert('修改成功'); } }); }, 'click .remove': function (e, value, row, index) { $.ajax({ type: "post", data: row, url: '/Analyze/DeleteMeterMeasureHistoryData', success: function (data) { alert('刪除成功'); $('#querylist').bootstrapTable('remove', { field: 'MeterMeasureHistoryID', values: [row.MeterMeasureHistoryID] }); } }); } };
columns 參數用來設置表格的所有列及每列參數:field 對應 json 返回數據的鍵值與列參數;title 對應顯示的列名;sortable 設置按當前列排序;formatter 設置單元格格式;editable 設置單元格編輯方式,並可設置 validate 驗證。
因此實際表格設為四列,依第 1 列排序,第 2、3 列可編輯(type 設為 text,也可按需換成其他類型),第 2 列驗證不能為空,第 3 列驗證為時間;第 1、2、3 列內容來自服務端返回的 json;第 4 列是對當前行數據的操作,並加入監聽事件 operateEvents,綁定到 window 上。

sortName 設為第 1 列 field 值;sortOrder 設為逆序;pagination 為 true 表示分頁;sidePagination 為 server 表示服務端分頁;pageNumber 表示默認起始頁;pageSize 表示每頁顯示條數;pageList 表示可選的每頁條數;queryParams 表示每次發送給服務端的參數,可自定義;url 是數據請求地址。
查看 bootstrap-table.js 可看到默認的 params 參數:
BootstrapTable.prototype.initServer = function (silent, query) { var that = this, data = {}, params = { pageSize: this.options.pageSize === this.options.formatAllRows() ? this.options.totalRows : this.options.pageSize, pageNumber: this.options.pageNumber, searchText: this.searchText, sortName: this.options.sortName, sortOrder: this.options.sortOrder }; if (!this.options.url) { return; } if (this.options.queryParamsType === 'limit') { params = { search: params.searchText, sort: params.sortName, order: params.sortOrder }; if (this.options.pagination) { params.limit = this.options.pageSize === this.options.formatAllRows() ? this.options.totalRows : this.options.pageSize; params.offset = this.options.pageSize === this.options.formatAllRows() ? : this.options.pageSize * (this.options.pageNumber - 1); } }
服務端需實現三個功能:數據加載、數據修改與刪除。
public ActionResult GetJsonHistoryDatas() { var displayStart = int.Parse(Request["offset"]); var displayLength = int.Parse(Request["pageSize"]); var meterID = int.Parse(Request["MeterID"]); var order = Request["sortOrder"]; var historyDatas = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID). OrderByDescending(p => p.Timestamp). Skip(displayStart). Take(displayLength).ToList();//顯示最近的 displayLength 條數據 if ("asc" == order) { historyDatas = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID). OrderBy(p => p.Timestamp). Skip(displayStart). Take(displayLength).ToList();//顯示最早的 displayLength 條數據 } int historyDataTotal = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID).Count();//數據總條數 //時間過濾 if (!String.IsNullOrEmpty(Request["begintime"])) { DateTime begintime = DateTime.Parse(Request["begintime"]); DateTime endtime = DateTime.Parse(Request["endtime"]); historyDatas = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID). Where(p => p.Timestamp > begintime && p.Timestamp < endtime). OrderByDescending(p => p.Timestamp). Skip(displayStart). Take(displayLength).ToList();//顯示最近的 displayLength 條數據 if ("asc" == order) { historyDatas = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID). Where(p => p.Timestamp > begintime && p.Timestamp < endtime). OrderBy(p => p.Timestamp). Skip(displayStart). Take(displayLength).ToList();//顯示最早的 displayLength 條數據 } historyDataTotal = db.MeterMeasureHistories. Where(p => p.MeterMeasure.MeterID == meterID). Where(p => p.Timestamp > begintime && p.Timestamp < endtime).Count();//數據總條數 } List<MeterMeasureHistoryDataViewModels> ListMeterMeasureHistories = new List<MeterMeasureHistoryDataViewModels>(); foreach (var item in historyDatas) { ListMeterMeasureHistories.Add(new MeterMeasureHistoryDataViewModels { MeterMeasureHistoryID = item.MeterMeasureHistoryID, Value = item.Value, Timestamp = item.Timestamp.ToString() }); } string jsonDataTable = JsonConvert.SerializeObject( new { total = historyDataTotal, rows = ListMeterMeasureHistories }); return Content(jsonDataTable); }
其中實現了分頁與數據查詢,返回的 json 包含 total(總數)與 rows(需顯示的數據)兩個對象。MeterMeasureHistoryDataView 如下,對應 Table 中的 field 值:
public class MeterMeasureHistoryDataViewModels { public int MeterMeasureHistoryID { get; set; } public double Value { get; set; } public string Timestamp { get; set; } }
數據修改函數:
[HttpPost] public JsonResult EditMeterMeasureHistoryData() { var metermeasurehistoryid = int.Parse(Request["MeterMeasureHistoryID"]); var metermeasurehistoryvalue = double.Parse(Request["Value"]); var metermeasurehistorytime = DateTime.Parse(Request["Timestamp"]); var metermeasurehistoryInDb = db.MeterMeasureHistories.Find(metermeasurehistoryid); metermeasurehistoryInDb.Value = metermeasurehistoryvalue; metermeasurehistoryInDb.Timestamp = metermeasurehistorytime; db.SaveChanges(); var changedData = new MeterMeasureHistoryDataViewModels { MeterMeasureHistoryID = metermeasurehistoryInDb.MeterMeasureHistoryID, Value = metermeasurehistoryInDb.Value, Timestamp = metermeasurehistoryInDb.Timestamp.ToString() }; JsonResult js = new JsonResult(); js.Data = Json(changedData); return js; }
數據刪除函數:
[HttpPost] public JsonResult DeleteMeterMeasureHistoryData() { var metermeasurehistoryid = int.Parse(Request["MeterMeasureHistoryID"]); db.MeterMeasureHistories.Remove(db.MeterMeasureHistories.Find(metermeasurehistoryid)); db.SaveChanges(); var deletedData = new MeterMeasureHistoryDataViewModels { MeterMeasureHistoryID = metermeasurehistoryid, Value = 0, Timestamp = null }; JsonResult js = new JsonResult(); js.Data = deletedData; return js; }
服務端刪除後,前台通過 bootstrap Table 的 remove 方法刪除指定數據行。
總結一下學習過程:查官方文檔與示例、看源碼,並學會使用 Chrome 開發者工具查看 Sources 與 Network。
以上就是 Bootstrap Table 服務端分頁與在線編輯的實踐總結,希望對大家有所幫助。