bootstrap table系列:
js表格组件神器bootstrap table详解(基础版)
js组件系列之bootstrap table表格组件神器【终结篇】
js组件系列之bootstrap table表格组件神器【二、父子表和行列调序】
bootstrap table是轻量级的和功能丰富的以表格的形式显示的数据,支持单选,复选框,排序,分页,显示/隐藏列,固定标题滚动表,响应式设计,ajax加载json数据,点击排序的列,卡片视图等。那么本文给大家介绍js组件系列之bootstrap table表格组件神器【终结篇】,一起学习吧!
一、效果展示
1、表格行样式
比如我们有一个显示订单页面的需求,不同状态的订单显示不同的颜色,如图:
2、表格行内编辑
第一篇的时候有园友就问过博主是否可以支持行内编辑的效果,答案是肯定的。我们先来看看效果:
编辑前
点击某个单元格数据
编辑后完成后
3、表格行列合并
关于行列合并的需求博主觉得是非常常见的,尤其是做页面报表的时候需要用到。先来看看效果:
当前页显示不全,点击进入看看。怎么样?效果还不错吧。
4、表格数据导出
关于表格数据导出,bootstrap table支持三种模式的导出:basic、all、selected。也就是当前页数据导出、所有数据导出、选中数据导出。并且支持导出多种类型的文件,比如常见的excel、xml、json等格式。
导出当前页到excel
导出表格所有数据
导出选中行数据
至于其他类型的文件的导出,和excel基本相同,就不做效果展示了。
二、表格行样式代码示例
关于表格行的样式设置,其他是它一个最基础的功能,为什么要把它放在第三篇?是因为博主觉得这功能可能到处都用得着。当然,效果并不难,自己用jquery设置tr的背景色也可以实现,但是博主觉得,既然bootstrap table提供了机制设置行的背景色,我们何不用它内置的api呢。我们看看如何实现。
初始化表格的时候
//初始化table$('#tb_order').bootstraptable({url: '/tablestyle/getorder', //请求后台的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, //是否显示父子表rowstyle: function (row, index) {//这里有5个取值代表5中颜色['active', 'success', 'info', 'warning', 'danger'];var strclass = ;if (row.order_status == 待排产) {strclass = 'success';//还有一个active}else if (row.order_status == 已删除) {strclass = 'danger';}else {return {};}return { classes: strclass }},columns: [{checkbox: true}, {field: 'order_no',title: '订单编号'}, {field: 'order_type',title: '订单类型'}, {field: 'order_status',title: '订单状态'}, {field: 'remark',title: '备注'}, ]});
其实重点就在这个参数里面:
rowstyle: function (row, index) {//这里有5个取值代表5中颜色['active', 'success', 'info', 'warning', 'danger'];var strclass = ;if (row.order_status == 待排产) {strclass = 'success';//还有一个active}else if (row.order_status == 已删除) {strclass = 'danger';}else {return {};}return { classes: strclass }},
bootstrap table支持5中表格的行背景色,分别是'active', 'success', 'info', 'warning', 'danger'这五种,至于每种对应的背景颜色,将代码运行起来就可看到。关于这个方法的返回值,博主第一次用的时候也研究了好久,按照bootstrap table的规则,必须返回一个json格式的对象型如: { classes: strclass } 。
三、表格行内编辑代码示例
关于表格行内编辑,需要使用bootstrap table扩展的几个js文件。
1、引入额外的js文件
2、在cshtml页面定义表格时,添加两个属性
部门名称上级部门部门级别描述
如果是在js里面初始化,写法如下:
{field: name,title: 名称,editable:true}
3、在js里面初始化表格的时候注册编辑保存的事件
$('#tb_departments').bootstraptable({url: '/editable/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, //每页的记录行数(*)oneditablesave: function (field, row, oldvalue, $el) {$.ajax({type: post,url: /editable/edit,data: { strjson: json.stringify(row) },success: function (data, status) {if (status == success) {alert(编辑成功);}},error: function () {alert(error);},complete: function () {}});}});
重点还是看看这个事件的处理方法
oneditablesave: function (field, row, oldvalue, $el) {$.ajax({type: post,url: /editable/edit,data: { strjson: json.stringify(row) },success: function (data, status) {if (status == success) {alert(编辑成功);}},error: function () {alert(error);},complete: function () {}});}
对应的方法里面需要自己处理保存的逻辑。四个参数field, row, oldvalue, $el分别对应着当前列的名称、当前行数据对象、更新前的值、编辑的当前单元格的jquery对象。
四、表格行列合并代码示例
表格的行列合并功能不用引用其他的js文件,只需要在cshtml页面使用table的colspan和rowspan即可实现。
1、cshtml页面
第一季度第二季度第三季度第四季度年度汇总
一月二月三月第一季度四月五月六月第二季度七月八月九月第三季度十月十一月十二月第四季度
2、js初始化并无特殊
$('#tb_report').bootstraptable({url: '/groupcolumns/getreport', //请求后台的url(*)method: 'get', //请求方式(*)toolbar: '#toolbar', //工具按钮用哪个容器striped: true, //是否显示行间隔色cache: false, //是否使用缓存,默认为true,所以一般情况下需要设置一下这个属性(*)pagination: true, //是否显示分页(*)sortorder: asc, //排序方式queryparams: otableinit.queryparams,//传递参数(*)sidepagination: server, //分页方式:client客户端分页,server服务端分页(*)pagenumber: 1, //初始化加载第一页,默认第一页pagesize: 10, //每页的记录行数(*)pagelist: [10, 25, 50, 100], //可供选择的每页的行数(*)});
怎么样,有没有很简单。当然,有人说了,你都可以不用js初始化,直接在cshtml里面用table的属性去设置url、分页等信息。确实,如果我们看过它的api,会发现它初始化的每一个属性都对应一个table的属性。型如
如果你的表格没有一些特殊的事件需要处理,这样是完全没有问题的。
五、表格数据导出代码示例
表格数据的导出功能也需要一些扩展的js支持。
1、引入额外的js文件
2、js初始化的时候
$('#tb_departments').bootstraptable({url: '/export/getdepartment', //请求后台的url(*)method: 'get', //请求方式(*)toolbar: '#toolbar', //工具按钮用哪个容器striped: true, //是否显示行间隔色cache: false, //是否使用缓存,默认为true,所以一般情况下需要设置一下这个属性(*)pagination: true, //是否显示分页(*)sortable: false, //是否启用排序sortorder: asc, //排序方式queryparams: otableinit.queryparams,//传递参数(*)sidepagination: client, //分页方式:client客户端分页,server服务端分页(*)pagenumber: 1, //初始化加载第一页,默认第一页pagesize: 10, //每页的记录行数(*)pagelist: [10, 25, 50, 100], //可供选择的每页的行数(*)clicktoselect:true,showexport: true, //是否显示导出exportdatatype: basic, //basic', 'all', 'selected'.columns: [{checkbox: true}, {field: 'name',title: '部门名称'}, {field: 'parentname',title: '上级部门'}, {field: 'level',title: '部门级别'}, {field: 'desc',title: '描述'}, ]});
还是来看重点:这两个属性
showexport: true, //是否显示导出exportdatatype: basic, //basic', 'all', 'selected'.showexport表示是否显示导出的按钮,exportdatatype表示导出的模式是当前页、所有数据还是选中数据。
六、总结
以上就是功能的效果以及实现的简单代码。博主发现有几个问题有待解决。
1、行内编辑的功能是每一个单元格提交到后台,这样会造成数据库的频繁操作,感觉不太合适。不知道有没有更好的方式,每行提交到后台。
2、导出的功能虽然很好用,但是遗憾的是不支持ie浏览器,博主试过官网上面的example,好像ie也导出不了。待验证。
以上所述是小编给大家介绍的js组件系列之bootstrap table表格组件神器【终结篇】的相关内容,希望对大家有所帮助!