`

JS组件系列——表格组件神器:bootstrap table(三:终结篇,最后的干货福利)

阅读更多

原文链接:http://www.cnblogs.com/landeanfen/p/5005367.html

 

前言:前面介绍了两篇关于bootstrap table的基础用法,这章我们继续来看看它比较常用的一些功能,来个终结篇吧,毛爷爷告诉我们做事要有始有终~~bootstrap table这东西要想所有功能覆盖似乎不太现实,博主挑选了一些自认为比较常用的功能在此分享给各位园友。源码也在这篇统一给出。好了,不多说废话,开始我们的干货之旅吧。

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文件

<link rel="stylesheet" href="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/css/bootstrap-editable.css">
<script src="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/js/bootstrap-editable.js"></script>
<script src="~/Content/bootstrap-table/extensions/editable/bootstrap-table-editable.js"></script>

2、在cshtml页面定义表格时,添加两个属性

复制代码
<table id="tb_departments">
        <thead>
            <tr>
                <th data-field="Name" data-editable="true">部门名称</th>
                <th data-field="ParentName">上级部门</th>
                <th data-field="Level" data-editable="true">部门级别</th>
                <th data-field="Desc" data-editable="true">描述</th>
            </tr>
        </thead>
    </table>
复制代码

如果是在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页面

复制代码
<table id="tb_report">
        <thead>
            <tr>
                <th colspan="4" data-valign="middle" data-align="center">第一季度</th>
                <th colspan="4" data-valign="middle" data-align="center">第二季度</th>
                <th colspan="4" data-valign="middle" data-align="center">第三季度</th>
                <th colspan="4" data-valign="middle" data-align="center">第四季度</th>
                <th data-field="TotalCount" rowspan="2" data-valign="middle" data-align="center">年度汇总</th>
            </tr>
            <tr>
                <th data-field="JanCount" data-align="center">一月</th>
                <th data-field="FebCount" data-align="center">二月</th>
                <th data-field="MarCount" data-align="center">三月</th>
                <th data-field="FirstQuarter" data-align="center">第一季度</th>

                <th data-field="AprCount" data-align="center">四月</th>
                <th data-field="MayCount" data-align="center">五月</th>
                <th data-field="JunCount" data-align="center">六月</th>
                <th data-field="SecondQuarter" data-align="center">第二季度</th>

                <th data-field="JulCount" data-align="center">七月</th>
                <th data-field="AguCount" data-align="center">八月</th>
                <th data-field="SepCount" data-align="center">九月</th>
                <th data-field="ThirdQuarter" data-align="center">第三季度</th>

                <th data-field="OctCount" data-align="center">十月</th>
                <th data-field="NovCount" data-align="center">十一月</th>
                <th data-field="DecCount" data-align="center">十二月</th>
                <th data-field="ForthQuarter" data-align="center">第四季度</th>
                
            </tr>
        </thead>
    </table>
复制代码

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文件

<script src="~/Content/bootstrap-table/extensions/export/bootstrap-table-export.js"></script>
<script src="//rawgit.com/hhurz/tableExport.jquery.plugin/master/tableExport.js"></script>

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-附件资源

    【JS组件系列】——表格组件神器:bootstrap table-附件资源

    JS组件系列之Bootstrap table表格组件神器【终结篇】

    JS组件系列之Bootstrap table表格组件神器【终结篇】 JS组件系列之Bootstrap table表格组件神器【二、父子表和行列调序】 Bootstrap Table是轻量级的和功能丰富的以表格的形式显示的数据,支持单选,复选框,排序,...

    bootstrap table-js.rar

    Bootstrap Table是一款基于Bootstrap框架的动态数据表格插件,它提供了丰富的功能,如排序、过滤、分页、自定义列等,极大地增强了网页中表格的交互性和用户体验。在使用"bootstrap table-js.rar"这个压缩包时,你...

    bootstrap table组件API

    在使用Bootstrap Table时,首先需要引入必要的CSS和JavaScript库,包括Bootstrap的核心CSS和JS,以及Bootstrap Table的JS和CSS。然后,通过简单的HTML标记和JavaScript调用,就可以将普通的HTML表格转化为功能强大的...

    基于Bootstrap table组件实现多层表头的实例代码

    Bootstrap Table是一个功能强大的表格组件,它提供了许多有用的功能,包括多层表头的实现。在本文中,我们将分享基于Bootstrap Table组件实现多层表头的实例代码。 多层表头是指在表格中实现多个层次的表头,每个...

    bootstrap table demo

    6. **JavaScript API**:Bootstrap Table 提供了丰富的 JavaScript API,包括初始化表格(`table.bootstrapTable()`),加载数据(`table.bootstrapTable('load', data)`),刷新表格(`table.bootstrapTable('...

    bootstrapTable实现列宽可拖动

    BootstrapTable 是一个基于 Bootstrap 框架的前端数据表格插件,它提供了丰富的功能,如分页、排序、过滤、自定义列等。在实际应用中,有时我们需要根据数据显示的需求调整列宽,以便更好地查看和理解表格内容。...

    bootstrap-table-demo

    8. **API与事件**:Bootstrap Table 提供了一系列的API方法(如`refresh`, `load`, `toggleColumn`等)用于在运行时操作表格,以及一系列的事件(如`load-success`, `column-switch`等)供开发者监听和响应。...

    bootstraptable-reorder-columns表格拖拽排序列

    BootstrapTable 是一个流行的开源前端组件库,用于创建交互式、响应式的HTML表格。"bootstraptable-reorder-columns" 是这个库的一个扩展插件,专门用于实现表格列的拖拽排序功能。用户可以通过简单的拖放操作来调整...

    基于javaweb 的bootstrap table使用案例源码下载

    在JavaWeb开发中,Bootstrap Table是一种非常流行的前端组件,它结合了Bootstrap框架的美观性和功能强大的数据展示能力。本案例提供了使用Bootstrap Table与Ajax进行交互的详细示例,旨在帮助开发者更好地理解和应用...

    bootstrap_table api

    6. **API方法**:Bootstrap Table提供了一系列API方法,用于动态操作表格,如`load`加载数据,`toggleColumn`切换列显示,`refresh`刷新数据等。 7. **自定义列格式**:通过`formatter`函数,可以自定义单元格内容...

    将bootstrap-table表格翻译为中文

    Bootstrap表格是前端开发中常用的组件,它为网页提供了一种美观、响应式的表格展示方式。Bootstrap-table 是基于Bootstrap框架的扩展插件,它允许开发者在网页中创建功能丰富的表格,包括排序、过滤、分页、行编辑等...

    基于bootstrap-table的穿梭框

    这可能包括`bootstrap-table.css`, `bootstrap-table.js`, `bootstrap-table-transfer.css`, 和 `bootstrap-table-transfer.js`。 2. **HTML结构**:创建基本的HTML结构,包括两个`&lt;table&gt;`元素,分别用作左侧面板...

Global site tag (gtag.js) - Google Analytics