前言
新的一年悄然到來,生活依舊。最近一周大熱的趙雷風,一首《成都》,一首《理想》再次把民謠展示在國人面前。歌詞着實寫的不錯。
理想,你今年幾歲
你總是誘惑着年輕的朋友
你總是謝了又開 給我驚喜
又讓我沉入失望的生活里
。。。。
我已不是無悔的那個青年
青春被時光拋棄
已是當父親的年紀
理想永遠都年輕
你讓我倔強的反抗着命運
你讓我變得蒼白
卻依然天真的相信
花兒會再次的盛開
等等,這和我們今天的主題貌似沒半毛錢關系。好了,再扯就扯遠了,今天和大家分享的是 Bootstrap Table 點我查看效果
或者直接看簡版效果如下(一個簡單的后台管理,實現了增刪查改):
bottstrap相關
既然說是bootstrap table 那肯定是bootstrap實現的(這是句廢話)。
關於bottstrap相關文檔如下:
Bootstrap中文網:http://www.bootcss.com/
Bootstrap Table Demo:http://issues.wenzhixin.net.cn/bootstrap-table/index.html
Bootstrap Table API:http://bootstrap-table.wenzhixin.net.cn/zh-cn/documentation/
Bootstrap Table源碼:https://github.com/wenzhixin/bootstrap-table
Bootstrap DataPicker:http://www.bootcss.com/p/bootstrap-datetimepicker/
Boostrap Table 擴展API:http://bootstrap-table.wenzhixin.net.cn/extensions/
bottstrap引入
關於引入有兩種方式,一種是直接下載源碼,然后放到項目中,bottstrap包可以到http://v3.bootcss.com/ 中找到。
第二種方法就是使用打開Nuget,搜索這兩個包
而Bootstrap Table的版本竟然是0.4,這也太坑爹了。所以博主建議Bootstrap Table的包就直接在源碼里面去下載吧。Bootstrap Table最新的版本好像是1.9.0。
代碼解析
@{ Layout = null; } <!DOCTYPE html> <html> <head> <meta name="viewport" content="width=device-width" /> <title>BootStrap Table使用</title> @*1、Jquery組件引用*@ <script src="~/Scripts/jquery-1.10.2.js"></script> @*2、bootstrap組件引用*@ <script src="~/Content/bootstrap/bootstrap.js"></script> <link href="~/Content/bootstrap/bootstrap.css" rel="stylesheet" /> @*3、bootstrap table組件以及中文包的引用*@ <script src="~/Content/bootstrap-table/bootstrap-table.js"></script> <link href="~/Content/bootstrap-table/bootstrap-table.css" rel="stylesheet" /> <script src="~/Content/bootstrap-table/locale/bootstrap-table-zh-CN.js"></script> @*4、頁面Js文件的引用*@ <script src="~/Scripts/Home/Index.js"></script> </head> <body> <div class="panel-body" style="padding-bottom:0px;"> <div class="panel panel-default"> <div class="panel-heading">查詢條件</div> <div class="panel-body"> <form id="formSearch" class="form-horizontal"> <div class="form-group" style="margin-top:15px"> <label class="control-label col-sm-1" for="txt_search_departmentname">部門名稱</label> <div class="col-sm-3"> <input type="text" class="form-control" id="txt_search_departmentname"> </div> <label class="control-label col-sm-1" for="txt_search_statu">狀態</label> <div class="col-sm-3"> <input type="text" class="form-control" id="txt_search_statu"> </div> <div class="col-sm-4" style="text-align:left;"> <button type="button" style="margin-left:50px" id="btn_query" class="btn btn-primary">查詢</button> </div> </div> </form> </div> </div> <div id="toolbar" class="btn-group"> <button id="btn_add" type="button" class="btn btn-default"> <span class="glyphicon glyphicon-plus" aria-hidden="true"></span>新增 </button> <button id="btn_edit" type="button" class="btn btn-default"> <span class="glyphicon glyphicon-pencil" aria-hidden="true"></span>修改 </button> <button id="btn_delete" type="button" class="btn btn-default"> <span class="glyphicon glyphicon-remove" aria-hidden="true"></span>刪除 </button> </div> <table id="tb_departments"></table> </div> </body> </html>
引入需要的文件之后,我們最重要的就是定義一個空的table,如上的 <table id="tb_departments"></table> 。當然Bootstrap table還提供了一種簡介的用法,直接在table標簽里面定義類似“data-...”等相關屬性,就不用再js里面注冊了,但博主覺得這種用法雖然簡單,但不太靈活,遇到父子表等這些高級用法的時候就不太好處理了,所以咱們還是統一使用在js里面初始化的方式來使用table組件。
Js初始化
$(function () { //1.初始化Table var oTable = new TableInit(); oTable.Init(); //2.初始化Button的點擊事件 var oButtonInit = new ButtonInit(); oButtonInit.Init(); }); var TableInit = function () { var oTableInit = new Object(); //初始化Table oTableInit.Init = function () { $('#tb_departments').bootstrapTable({ url: '/Home/GetDepartment', //請求后台的URL(*) method: 'get', //請求方式(*) toolbar: '#toolbar', //工具按鈕用哪個容器 striped: true, //是否顯示行間隔色 cache: false, //是否使用緩存,默認為true,所以一般情況下需要設置一下這個屬性(*) pagination: true, //是否顯示分頁(*) sortable: false, //是否啟用排序 sortOrder: "asc", //排序方式 queryParams: oTableInit.queryParams,//傳遞參數(*) sidePagination: "server", //分頁方式:client客戶端分頁,server服務端分頁(*) pageNumber:1, //初始化加載第一頁,默認第一頁 pageSize: 10, //每頁的記錄行數(*) pageList: [10, 25, 50, 100], //可供選擇的每頁的行數(*) search: true, //是否顯示表格搜索,此搜索是客戶端搜索,不會進服務端,所以,個人感覺意義不大 strictSearch: true, showColumns: true, //是否顯示所有的列 showRefresh: true, //是否顯示刷新按鈕 minimumCountColumns: 2, //最少允許的列數 clickToSelect: true, //是否啟用點擊選中行 height: 500, //行高,如果沒有設置height屬性,表格自動根據記錄條數覺得表格高度 uniqueId: "ID", //每一行的唯一標識,一般為主鍵列 showToggle:true, //是否顯示詳細視圖和列表視圖的切換按鈕 cardView: false, //是否顯示詳細視圖 detailView: false, //是否顯示父子表
columns: [{
checkbox: true
}
, {
field: 'MethodName',
title: '方法名'
}, {
field: 'OperType',
title: '日志類型'
}, {
field: 'LogFormat',
title: '內容格式'
}, {
field: 'ParamterValues',
title: '格式參數'
}, {
field: 'LogSql',
title: '數值'
}, {
field: 'SQLParamter',
title: '數值定義'
}, {
field: 'CreateDate',
title: '創建時間'
}
]
}); }; //得到查詢的參數 oTableInit.queryParams = function (params) { var temp = { //這里的鍵的名字和控制器的變量名必須一直,這邊改動,控制器也需要改成一樣的 limit: params.limit, //頁面大小 offset: params.offset, //頁碼 departmentname: $("#txt_search_departmentname").val(), statu: $("#txt_search_statu").val() }; return temp; }; return oTableInit; }; var ButtonInit = function () { var oInit = new Object(); var postdata = {}; oInit.Init = function () { //初始化頁面上面的按鈕事件 }; return oInit; };
表格的初始化也很簡單,定義相關的參數即可。上面一些博主覺得重要的參數都加了注釋,並且初始化Table必須的幾個參數博主也用(*)做了標記,如果你的表格也有太多的頁面需求,直接用必須的參數就能解決。同樣,在columns參數里面其實也有很多的參數需要設置,比如列的排序,對齊,寬度等等。這些博主覺得比較簡單,不會涉及表格的功能,看看API就能搞定。
注:如果需要隱藏某列,只需要即可
$('#tb_departments').bootstrapTable('hideColumn', '列名');
顯示某列
$('#tableOrderRealItems').bootstrapTable('showColumn', '列名');
在Controller里面對應的方法
public JsonResult GetDepartment(int limit, int offset, string departmentname, string statu) { var lstRes = new List<Department>(); for (var i = 0; i < 50; i++) { var oModel = new Department(); oModel.ID = Guid.NewGuid().ToString(); oModel.Name = "銷售部" + i ; oModel.Level = i.ToString(); oModel.Desc = "暫無描述信息"; lstRes.Add(oModel); } var total = lstRes.Count; var rows = lstRes.Skip(offset).Take(limit).ToList(); return Json(new { total = total, rows = rows }, JsonRequestBehavior.AllowGet); }
這里有一點需要注意:如果是服務端分頁,返回的結果必須包含total、rows兩個參數。漏寫或錯寫都會導致表格無法顯示數據。相反,如果是客戶端分頁,這里要返回一個集合對象到前端。
效果及說明
小結
第一個問題上面說過,如果在js里面初始化的參數 sidePagination: "server" 設置為在服務端分頁,那么我們的返回值必須告訴前端總記錄的條數和當前頁的記錄數,然后前端才知道如何分頁。並且最重要的一點,這兩個參數的名字必須為total和rows。最開始博主也不知道這個,寫成了total和row,結果是請求可以進到后台的GetDepartment方法,返回值total和row也都有值,可是前端就是顯示如下:
找了好半天原因。原來是row寫錯了,應該寫成rows。
第二個問題就是關於bootstrap頁面樣式的問題,我們使用過bootstrap的朋友應該知道,它里面所有的圖標都是通過class = "glyphicon glyphicon-plus"這種方式去寫的。博主按要求這樣做了,可是新增、修改、刪除前面的圖標怎么都出不來。如下:
怎么回事呢?然后各種百度,最后發現原來是fonts文件夾的問題。我們在新建一個MVC項目的時候,會自動創建一個fonts文件夾,里面內容如下:
而我們的bootstrap.css是放在Content文件夾里面的,這樣就導致找不到這些樣式文件。最終通過谷歌瀏覽器查看控制台
原來它自動去Content里面找fonts文件夾了。這下就好辦了,把我們的fonts文件夾拷貝到Content下不就行了嗎。呵呵,原來真是這樣,問題順利解決
Content文件夾中存放文件如下所示:
第三點要說說表格自帶的搜索功能,有上可知,在初始化表格的時候,通過設置search: true可以設置表格的搜索框出現並且可以進行模糊搜索。之前博主一直以為只有客戶端分頁才能使用這個搜索,多謝園友指出,其實服務端分頁也可以使用這個搜索功能。只不過需要在對應的方法里加上search參數。比如
oTableInit.queryParams = function (params) { var temp = { //這里的鍵的名字和控制器的變量名必須一直,這邊改動,控制器也需要改成一樣的 limit: params.limit, //頁面大小 offset: params.offset, //頁碼 departmentname: $("#txt_search_departmentname").val(), statu: $("#txt_search_statu").val(), search:params.search }; return temp; };
然后后端(后端可以根據這個參數值是否有值來判斷做什么查詢)
public JsonResult GetDepartment(int limit, int offset, string departmentname, string statu, string search) { var lstRes = new List<Department>(); for (var i = 0; i < 50; i++) { var oModel = new Department(); oModel.ID = Guid.NewGuid().ToString(); oModel.Name = "銷售部" + i ; oModel.Level = i.ToString(); oModel.Desc = "暫無描述信息"; lstRes.Add(oModel); } var total = lstRes.Count; var rows = lstRes.Skip(offset).Take(limit).ToList(); return Json(new { total = total, rows = rows }, JsonRequestBehavior.AllowGet); }
這樣,每次用戶在搜索框里面輸入都會進到后台的方法,並且將用戶輸入的值傳到search參數。但是如果你需要對多個字段進行模糊匹配,那么就意味着你的后台需要去對多個數據字段進行like操作,這樣查詢效率肯定低下。所以,如果需要模糊匹配的字段很多,這個search在實際項目中是用不上的。綜上,博主還是覺得只有在客戶端分頁的時候,這個搜索的作用比較明顯。
第四點:關於Bootstrap Table的排序,由於一般這種BS系統肯定會采用服務端分頁,我們如果僅僅在js里面設置sortable和sortOrder等屬性信息,表格是不會有效排序的。原因很簡單,服務端分頁的方式,排序本頁數據意義不大。所以,一般的排序需要將排序方式和排序字段發送到后台,在后台排序比較合適。比如我們這里可以再參數里面增加兩個:
oTableInit.queryParams = function (params) { var temp = { //這里的鍵的名字和控制器的變量名必須一直,這邊改動,控制器也需要改成一樣的 limit: params.limit, //頁面大小 offset: params.offset, //頁碼 order: params.order, ordername: params.sort, departmentname: $("#txt_search_departmentname").val(), statu: $("#txt_search_statu").val() }; return temp; };
Demo下載
百度網盤:點我下載 密碼:knct
git地址:https://github.com/XiaoYong666/bootstrap-table
補充:搭配一種后台風格效果更佳,如下圖所示:
然后提示框各種提示框推薦使用layer,效果如下:
后台布局是使用的bootstrap ,下面也放出布局Demo,有需要的小伙伴可以參考下:
鏈接:點我下載 密碼:w7g0
關於上圖中的提示框,是使用的layer彈出組件,使用方法非常簡單,官方下載出來得到如下所示文件,需要將整個文件都拷貝到項目目錄下, 然后只需要引用layer.js即可(需要引入jquery1.8及以上版本才支持layer)
更多關於layer的請各位小伙伴移步layer大本營:我要飛過去
本文原創地址:http://www.cnblogs.com/landeanfen/p/4976838.html