bootstrap table使用总结

最新推荐文章于 2025-05-29 11:56:13 发布

原创最新推荐文章于 2025-05-29 11:56:13 发布 · 4.6w 阅读

40 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #bootstrap

javascript 同时被 2 个专栏收录

30 篇文章

订阅专栏

bootstrap

1 篇文章

订阅专栏

本文介绍如何使用 Bootstrap Table 开发后台表格，实现数据的异步更新和编辑。文章涵盖基本配置、ThinkPHP 后台实现、复杂表格功能如行内编辑、文件上传等，并提供完整示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

使用bootstrap table可以很方便的开发后台表格，对数据进行异步更新，编辑。下面就来介绍一下bootstrap table的详细使用方法：

因为之前在官网也找了很久的教程，源码感觉隐藏的比较隐秘，其他扩展功能也很难找到，其实都在：http://issues.wenzhixin.net.cn/bootstrap-table/index.html这里面，点击上面的tab可以找到具体的功能实现（特别是extension和issues，之前以为issues不是教程，结果点进去才知道）：

最简单的异步表单

1.html中加入如下代码：

<table id="table"></table>

2.javascript

/*bootstrap table*/
$('#table').bootstrapTable({
    url:"/wadmin/permission/doRuleList",//请求数据url
    queryParams: function (params) {
        return {
            offset: params.offset,  //页码
            limit: params.limit,   //页面大小
            search : params.search, //搜索
            order : params.order, //排序
            ordername : params.sort, //排序
        };
    },
    showHeader : true,
    showColumns : true,
    showRefresh : true,
    pagination: true,//分页
    sidePagination : 'server',//服务器端分页
    pageNumber : 1,
    pageList: [5, 10, 20, 50],//分页步进值
    search: true,//显示搜索框
    //表格的列
    columns: [
        {
            field: 'id',//域值
            title: '规则ID',//标题
            visible: true,//false表示不显示
            sortable: true,//启用排序
            width : '5%',
        },
        {
            field: 'name',//域值
            title: '唯一英文标识',//标题
            visible: true,//false表示不显示
            sortable: true,//启用排序
            width : '30%',
            editable:true,
        },
        {
            field: 'title',//域值
            title: '中文描述',//内容
            visible: true,//false表示不显示
            sortable: true,//启用排序
            width : '35%',
            editable:true,
        },
        {
            field: 'status',//域值
            title: '状态',//内容
            visible: true,//false表示不显示
            sortable: true,//启用排序
            width : '20%',
            formatter : function (value, row, index) {
                if (row['status'] === 1) {
                    return '正常';
                }
                if (row['status'] === 0) {
                    return '禁用';
                }
                return value;
            }
        }
    ]
});

上面代码中，除了url和下面的column需要动态变之外，其他的基本上都是固定的，可以复制粘贴到处使用。因为规则的固定，所以后台的规则也是比较固定的。

3.thinkPHP5.0实现后台（主要是返回total和rows）

controller

public function doRoleRuleList() {
    $id = input("id");
    if (!$id) return "";

    $limit = input("limit");
    $offset = input("offset");
    $search = input("search");
    $order = input("order", "desc");
    $ordername = input("ordername");
    if (!$ordername) {
        $ordername = 'id';
        $order = 'desc';
    }

    $perModel = new PermissionModel();
    $rs = $perModel->doRoleRuleList($id, $offset, $limit, $search, $order, $ordername);

    return json($rs);
}

model

public function doRoleRuleList($id, $offset, $limit, $search, $order, $ordername) {
    $total = Db::connect("dbUser")->table("auth_rule")->where(['status'=>['<>', 0]])->count();
    $auth_group = Db::connect("dbUser")->table("auth_group")->field("id,rules")->where("id", $id)->find();
    $rules ="-1";
    if ($auth_group && $auth_group['rules']) $rules = $auth_group['rules'];

    $rows = Db::connect("dbUser")->table("auth_rule")
        ->field(['id','name','title',"if(id in ({$rules}), 1, 0)"=>'selected'])
        ->where([
            'status'=>['<>', 0],
//                'name|title' => ['like', "%{$search}%"]
        ])
        ->order($ordername." ".$order)
        ->select();


    return ['total'=>$total,'rows'=>$rows];
}

说明图：
这里写图片描述

复杂表格（行内编辑（编辑文字，下拉选择），样式改变，自定义图标，文件上传），因为js比较复杂，这里先列出代码功能的说明：

1.显示详情使用如下代码：
表格参数中添加代码

detailView : true,
detailFormatter : function (index, row) {
   var image = '<div class="photos">'
        +'<a target="_blank" href="'+row['jumpUrl']+'"><img alt="image" class="feed-photo" src="'+row['picUrl']+'"></a>'
        +'</div>';
    return image;
}

可以在detailFormatter进行代码的格式化，以字符串的形式返回即可，实现效果如下：

detailView

2.表格列内容的格式化
列参数中添加代码

formatter : function (value, row, index) {
    return "<img style='width: 50px;height: 50px;' src='"+value+"' alt=''>"
}

效果如下：
这里写图片描述

3 . 表格的样式自定义
列参数中添加带代码

cellStyle : function (value, row, index) {
    return {
        css: {
            "max-width": "300px",
            "word-wrap": "break-word",
            "word-break": "normal"
        }
    };
}

4 . 新增数据
在js文件中添加如下代码：

$("#btn_add").click(function () {
  $.ajax({
      type : "POST",
      url : "/wadmin/ad/addAd",
      dataType : 'JSON',
      success : function (data) {
          if (data.result != 0) {
              toastr.info("info", data.message);
              return ;
          }
          toastr.success("success", '标签');
          $("#table").bootstrapTable('insertRow', {index:0, row:data.data});
      }
  });

});

绑定的按钮是toolbar里面的，点击如果进行ajax请求，再根据请求的结果自行判断添加

这里写图片描述

5.表格中列格式化成图标并监听事件
6.文件上传（基于5）

列参数中添加如下代码

{
    field: 'operate',
    title: '操作',
    align: 'center',
    events: operateEvents,
    width : '25%',
    formatter: operateFormatter
}

operateFormatter（这里注意需要添加a标签包住图标，并添加class）

function operateFormatter(value, row, index) {
    return [
        '<a class="using" href="javascript:void(0)" title="Remove">',
        '<i class="fa fa-check"></i>',
        '</a>&nbsp;&nbsp;&nbsp;&nbsp;',
        '<a class="upload" style="cursor: pointer" href="javascript:void(0)" title="Upload">',
        '<label style="cursor: pointer" for="'+row['adId']+'">',
        '<i class="fa fa-upload"></i>',
        '<input type="file" name="adUpload" style="display: none;" class="adUpload" id="'+row['adId']+'" >',
        '</label>',
        '</a>&nbsp;&nbsp;&nbsp;&nbsp;',
        '<a class="remove" href="javascript:void(0)" title="Using">',
        '<i class="fa fa-times"></i>',
        '</a>',
    ].join('');
}

operateEvents（监听事件，注意这里是window.operateEvents）

window.operateEvents = {
    'click .remove': function (e, value, row, index) {
        $.ajax({
            type : "POST",
            url : "/wadmin/ad/deleteAd",
            data : {
                adId : row['adId']
            },
            dataType : 'JSON',
            success : function (data) {
                if (data.result != 0) {
                    toastr.info("info", data.message);
                    return ;
                }
                toastr.success("success", '删除成功');
                $("#table").bootstrapTable('remove', {
                    field: 'adId',
                    values: [row['adId']]
                });
            }
        });

        return false;
    },
    'click .using': function (e, value, row, index) {
        $.ajax({
            type : "POST",
            url : "/wadmin/ad/usingAd",
            data : {
                adId : row['adId']
            },
            dataType : 'JSON',
            success : function (data) {
                if (data.result != 0) {
                    toastr.info("info", data.message);
                    return ;
                }
                toastr.success("success", '使用该广告');
                $("#table").bootstrapTable('refresh');
            }
        });

        return false;
    },
    'click .upload': function (e, value, row, index) {
        $('.adUpload').fileupload({
            url : '/wadmin/ad/adUpload/adId/'+row['adId'],
            dataType: 'json',
            add: function (e, data) {
                data.submit();
            },
            done: function (e, data) {
                var response = data.result;
                if (response.result != 0) {
                    toastr.error(response.message);
                    return false;
                }
                toastr.success("上传成功");
                $("#table").bootstrapTable('refresh');
            }
        });

        return false;
    }
};

实现的效果如下：

这里写图片描述

7.行内编辑
普通的编辑只需要在列参数中设置即可：
列参数中添加代码

editable : true,

需要下拉编辑的，使用如下代码：

editable: {
   type: 'select',
   source: [ //0->无广告，1->静态不可点击，2->静态可点击，3->动态不可点击，4->动态可点击
       {value: 0, text: '无广告'},
       {value: 1, text: '静态不可点击'},
       {value: 2, text: '静态可点击'},
       {value: 3, text: '动态不可点击'},
       {value: 4, text: '动态可点击'},
   ]
}

这里还有一些行内编辑的样式是需要导入第三方lib的，比如说如果要实现行内时间的编辑，需要下载导入combodate.js ，然后添加如下代码（这些js文件后面会给出的，也可以去官网下载最新版）：

editable: {
    type: 'combodate',
    viewformat: 'YYYY-MM-DD HH:mm:ss',
    template: 'YYYY-MM-DD HH:mm:ss',
    format: 'YYYY-MM-DD HH:mm:ss',
    combodate: {
        minuteStep: 1,
        secondStep: 1,
        maxYear: 5000,
        minYear: 2016,
    }
}

然后再表格参数中添加如下代码监听事件：

onEditableSave: function (field, row, oldValue, $el) {
   $.ajax({
        type: "post",
        url: "/wadmin/ad/updateAdInfo",
        dataType : 'json',
        data: row,
        success: function (data, status) {
            if (status == "success" && data.result == 0) {
                toastr.success('更新成功');
                if (field == 'jumpUrl') {
                    $('#table').bootstrapTable("refresh");
                }
                return true;
            } else {
                toastr.info(data.message);
                $('#table').bootstrapTable("refresh");
            }
        },
        error: function () {
            alert("Error");
        },
        complete: function () {

        }

    });
}

实现的效果如下：
这里写图片描述

这里写图片描述

其中，调用bootstraptable的一些方法可以动态更新表格（增删改等），用法如下：

$("#table").bootstrapTable('insertRow', {index:0, row:data.data});
$("#table").bootstrapTable('remove', {
    field: 'adId',
    values: [row['adId']]
});
$("#table").bootstrapTable('refresh');
$("#table").bootstrapTable('updateCell', {
    index : index,
    field: 'status',
    value: row['status'] ? 0 : 1
});

因为引入的js和css库有点多，而且需要实现行内编辑的话需要需要引入的js文件比较难找，下面给出下载地址（密码：jjdk）：

http://pan.baidu.com/s/1bpiRObt

完整代码

html

<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>
</div>
<table id="table"></table>

javascript

/**
 * Created by raid on 2016/12/28.
 */
$(function () {
    window.operateEvents = {
        'click .remove': function (e, value, row, index) {
            $.ajax({
                type : "POST",
                url : "/wadmin/ad/deleteAd",
                data : {
                    adId : row['adId']
                },
                dataType : 'JSON',
                success : function (data) {
                    if (data.result != 0) {
                        toastr.info("info", data.message);
                        return ;
                    }
                    toastr.success("success", '删除成功');
                    $("#table").bootstrapTable('remove', {
                        field: 'adId',
                        values: [row['adId']]
                    });
                }
            });

            return false;
        },
        'click .using': function (e, value, row, index) {
            $.ajax({
                type : "POST",
                url : "/wadmin/ad/usingAd",
                data : {
                    adId : row['adId']
                },
                dataType : 'JSON',
                success : function (data) {
                    if (data.result != 0) {
                        toastr.info("info", data.message);
                        return ;
                    }
                    toastr.success("success", '使用该广告');
                    $("#table").bootstrapTable('refresh');
                }
            });

            return false;
        },
        'click .upload': function (e, value, row, index) {
            $('.adUpload').fileupload({
                url : '/wadmin/ad/adUpload/adId/'+row['adId'],
                dataType: 'json',
                add: function (e, data) {
                    data.submit();
                },
                done: function (e, data) {
                    var response = data.result;
                    if (response.result != 0) {
                        toastr.error(response.message);
                        return false;
                    }
                    toastr.success("上传成功");
                    $("#table").bootstrapTable('refresh');
                }
            });

            return false;
        }
    };


    /*bootstrap table*/
    $('#table').bootstrapTable({
        url:"/wadmin/ad/doAdList",//请求数据url
        toolbar : "#toolbar",
        // toolbarAlign : "right",
        queryParams: function (params) {
            return {
                offset: params.offset,  //页码
                limit: params.limit,   //页面大小
                search : params.search, //搜索
                order : params.order, //排序
                ordername : params.sort, //排序
            };
        },
        detailView : true,
        detailFormatter : function (index, row) {
            var image = '<div class="photos">'
                +'<a target="_blank" href="'+row['jumpUrl']+'"><img alt="image" class="feed-photo" src="'+row['picUrl']+'"></a>'
                +'</div>';
            return image;
        },
        showHeader : true,
        showColumns : true,
        showRefresh : true,
        pagination: true,//分页
        sidePagination : 'server',//服务器端分页
        pageNumber : 1,
        pageList: [5, 10, 20, 50],//分页步进值
        search: true,//显示搜索框
        //表格的列
        columns: [
            {
                field: 'adId',//域值
                title: '广告ID',//标题
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '5%',
            },
            {
                field: 'picUrl',//域值
                title: '图片',//标题
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '15%',
                formatter : function (value, row, index) {
                    return "<img style='width: 50px;height: 50px;' src='"+value+"' alt=''>"
                }
            },
            {
                field: 'jumpUrl',//域值
                title: '跳转链接',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
                editable : true,
                cellStyle : function (value, row, index) {
                    return {
                        css: {
                            "max-width": "300px",
                            "word-wrap": "break-word",
                            "word-break": "normal"
                        }
                    };
                }
            },
            {
                field: 'adDesc',//域值
                title: '描述',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
                editable : true,
            },
            {
                field: 'displayType',//域值
                title: '表现形式',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
                editable: {
                    type: 'select',
                    source: [ //0->无广告，1->静态不可点击，2->静态可点击，3->动态不可点击，4->动态可点击
                        {value: 0, text: '无广告'},
                        {value: 1, text: '静态不可点击'},
                        {value: 2, text: '静态可点击'},
                        {value: 3, text: '动态不可点击'},
                        {value: 4, text: '动态可点击'},
                    ]
                }
            },
            {
                field: 'displaySeconds',//域值
                title: '时间',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '5%',
                editable : true,
            },
            {
                field: 'scope',//域值
                title: '影响范围',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
                editable: {
                    type: 'select',
                    source: [ //0->全国
                        {value: 0, text: '全国'},
                    ]
                }
            },
            {
                field: 'userType',//域值
                title: '影响群体',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '5%',
                editable: {
                    type: 'select',
                    source: [ //0->全部
                        {value: 0, text: '全部'},
                    ]
                }
            },
            {
                field: 'status',//域值
                title: '状态',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
                formatter : function (value, row, index) {
                    return value==1||value=='1' ? '正在使用' : '没有使用';
                }
            },
            {
                field: 'addTime',//域值
                title: '时间',//内容
                visible: true,//false表示不显示
                sortable: true,//启用排序
                width : '10%',
            }
            ,{
                field: 'operate',
                title: '操作',
                align: 'center',
                events: operateEvents,
                width : '25%',
                formatter: operateFormatter
            }
        ],
        onEditableSave: function (field, row, oldValue, $el) {
            $.ajax({
                type: "post",
                url: "/wadmin/ad/updateAdInfo",
                dataType : 'json',
                data: row,
                success: function (data, status) {
                    if (status == "success" && data.result == 0) {
                        toastr.success('更新成功');
                        if (field == 'jumpUrl') {
                            $('#table').bootstrapTable("refresh");
                        }
                        return true;
                    } else {
                        toastr.info(data.message);
                        $('#table').bootstrapTable("refresh");
                    }
                },
                error: function () {
                    alert("Error");
                },
                complete: function () {

                }

            });
        }
    });

    $("#btn_add").click(function () {
        $.ajax({
            type : "POST",
            url : "/wadmin/ad/addAd",
            dataType : 'JSON',
            success : function (data) {
                if (data.result != 0) {
                    toastr.info("info", data.message);
                    return ;
                }
                toastr.success("success", '标签');
                $("#table").bootstrapTable('insertRow', {index:0, row:data.data});
            }
        });

    });

    function operateFormatter(value, row, index) {
        return [
            '<a class="using" href="javascript:void(0)" title="Remove">',
            '<i class="fa fa-check"></i>',
            '</a>&nbsp;&nbsp;&nbsp;&nbsp;',
            '<a class="upload" style="cursor: pointer" href="javascript:void(0)" title="Upload">',
            '<label style="cursor: pointer" for="'+row['adId']+'">',
            '<i class="fa fa-upload"></i>',
            '<input type="file" name="adUpload" style="display: none;" class="adUpload" id="'+row['adId']+'" >',
            '</label>',
            '</a>&nbsp;&nbsp;&nbsp;&nbsp;',
            '<a class="remove" href="javascript:void(0)" title="Using">',
            '<i class="fa fa-times"></i>',
            '</a>',
        ].join('');
    }
});