前言:以前一直在忙着各类什么效果,却不知最基础的Bootstrap Table用法都没有涉及,罪过,罪过。今天补起来吧。上午博主由零开始本身从头至尾使用了一遍Bootstrap Table ,遇到很多使用方面的问题,也作了一部分笔记,在此分享出来供须要使用的园友参考。还记得前两天有园友加群问我Bootstrap Table的使用问题,呵呵,巧了,今天博主也遇到一样的问题了,在此仍是要表示抱歉,没有将这篇提早发出来。css
bootstrap table系列:html
关于流式布局的bootstrap,博主也是最近半年才开始使用,用过以后才知道其实开源的东西挺不错的,仍是为bootstrap开源工做者点一个大大的赞!老规矩,贴出相关文档:前端
Bootstrap中文网:http://www.bootcss.com/ jquery
Bootstrap Table Demo:http://issues.wenzhixin.net.cn/bootstrap-table/index.htmlgit
Bootstrap Table API:http://bootstrap-table.wenzhixin.net.cn/zh-cn/documentation/github
Bootstrap Table源码:https://github.com/wenzhixin/bootstrap-tablebootstrap
Bootstrap DataPicker:http://www.bootcss.com/p/bootstrap-datetimepicker/后端
Boostrap Table 扩展API:http://bootstrap-table.wenzhixin.net.cn/extensions/浏览器
这里要说明一点:Bootstrap Table的离线API是博主本身在官网上面保存下来的,样式可能存在问题。博主也不想使用这种看起来乖乖的离线文档,但没办法,http://bootstrap-table.wenzhixin.net.cn/zh-cn/documentation/这网站常常性的打不开,貌似有被墙的可能性。下一步是否是要翻墙了,O(∩_∩)O~。
关于Bootstrap Table的引入,通常来讲仍是两种方法:
因为Bootstrap Table是Bootstrap的一个组件,因此它是依赖Bootstrap的,咱们首先须要添加Bootstrap的引用。Bootstrap的包直接在 http://v3.bootcss.com/ 里面能够找到,版本已经出来4的预览版,但仍是建议使用比较稳定的Bootstrap3,目前最新的3.3.5。而后就是Bootstrap Table的包了,因为它是开源的,咱们直接进到它的源码https://github.com/wenzhixin/bootstrap-table里面git下来就行了。而后把这两个包分别加入到项目中。
打开Nuget,搜索这两个包
Bootstrap已是最新的3.3.5了,咱们直接安装便可。
而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> @*一、Jquery组件引用*@ <script src="~/Scripts/jquery-1.10.2.js"></script> @*二、bootstrap组件引用*@ <script src="~/Content/bootstrap/bootstrap.js"></script> <link href="~/Content/bootstrap/bootstrap.css" rel="stylesheet" /> @*三、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> @*四、页面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组件。
$(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: 'Name', title: '部门名称' }, { field: 'ParentName', title: '上级部门' }, { field: 'Level', title: '部门级别' }, { field: 'Desc', 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就能搞定。
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两个参数。漏写或错写都会致使表格没法显示数据。相反,若是是客户端分页,这里要返回一个集合对象到前端。
仍是贴几张效果图出来:
因为是从零开始开发的以上功能,博主遇到一个问题能够和园友们分享一下,这应该也是今天这篇想表达的重点。
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); }
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; };
在以前的几年开发经历中,博主也使用Jqgrid、EasyUI等表格组件。相比而言,bootstrap Table有本身的优点:
一、界面采用扁平化的风格,用户体验比较好,更好兼容各类客户端。这点也是最重要的。
二、开源、免费。国人最喜欢的就是免费了。呵呵。
三、相对Jqgrid、easyUI而言,比较轻量级。功能不能说最全面,但基本够用。
至此,本篇就结束了,欢迎园友们拍砖。源码下载。
最近打算作点本身的东西出来,将博客里面的一些好的技术融合进去。有项目合做的小伙伴赶快联系博主吧!
本文原创出处:http://www.cnblogs.com/landeanfen/
欢迎各位转载,可是未经做者本人赞成,转载文章以后必须在文章页面明显位置给出做者和原文链接,不然保留追究法律责任的权利!