Bootstrap Table使用心得总结

Posted 2022-06-23 北漂周

之前一直在调研我们的管理后台使用的表格控件，查询到 : http://bootstrap-table.wenzhixin.net.cn

的Bootstrap Table 感觉挺不错，但是由于官方的文档不是怎么的完善，导致自己的网络数据请求一直没有通过。

今天终于调试通过，在这里与大家分享一下。

一、相关的配置文件引入

<!-- jQuery文件。务必在bootstrap.min.js 之前引入 -->
<script src="//cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script>
<link rel="stylesheet" href="//cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css">
<script src="//cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>

<!-- bootstrap table   -->
<link href="//cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table.min.css" rel="stylesheet">
<script src="//cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table.min.js"></script>
<script src="//cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table-locale-all.js"></script>
<script src="//cdn.bootcss.com/bootstrap-table/1.11.0/extensions/export/bootstrap-table-export.min.js"></script>
<!-- bootstrap table 包含excel导出，pdf导出 -->
<script src="https://rawgit.com/hhurz/tableExport.jquery.plugin/master/tableExport.js"></script>
<script src="//cdn.bootcss.com/FileSaver.js/2014-11-29/FileSaver.min.js"></script>

注意!!!!! 这里的 tableExport.js并不是 bootcdn上的tableExport，使用的时候注意看作者，不到会导致无法导出excel

二、编写表头和工具栏

其实整个表头的编写非常简单，只需要简单的几个配置就好。

• 注意，把每一个bean的属性书写在th中
• 注意绑定工具栏

可以参考如下配置

<!-- 工具栏的按钮，可以自定义事件 -->
<div id="toolbar" class="btn-group">
    <button type="button" class="btn btn-default">
        <i class="glyphicon glyphicon-plus"></i>
    </button>
    <button type="button" class="btn btn-default">
        <i class="glyphicon glyphicon-heart"></i>
    </button>
    <button type="button" class="btn btn-default">
        <i class="glyphicon glyphicon-trash"></i>
    </button>
</div>



<table id="demo" class="table table-striped table-hover table-bordered" 
    data-toolbar="#toolbar"  // 这里必须绑定工具栏，不然布局会错乱
    data-search="true" 
    data-show-refresh="true"
    data-show-columns="true"
    data-show-export="true"
    data-export-types="['excel']"
    data-export-options='   // 导出的文件名
     "fileName": "products", 
     "worksheetName": "products"
   '
    >
    <thead>
        <tr>
            <th width="3%" data-field="prodId">产品Id</th>
            <th width="10%" data-field="nameOfProduct">产品名称</th>
            <th width="4%" data-field="categoryId">产品类别</th>
            <th width="5%" data-field="domicileOfCapital">资本类型</th>
            <th width="8%" data-field="underwriter">发行机构</th>
            <th width="6%" data-field="managementInstitution">基金公司</th>
            <th width="5%" data-field="managementInstitution2">管理机构</th>
            <th width="3%" data-field="flag">角标</th>
            <th width="7%" data-field="beginTime">上线时间</th>
            <th width="7%" data-field="endTime">下线时间</th>
            <th width="4%" data-field="status">发布状态</th>
            <th width="4%" data-field="fundRaisingStatus">募集状态</th>
            <th width="3%" data-field="totalScore">打分</th>
            <th width="3%" data-field="modesOfGuaranteeScore">担保</th>
            <th width="3%" data-field="invsetmentTargetScore">投资</th>
            <th width="3%" data-field="underwriterScore">发行</th>
            <th width="3%" data-field="sourceOfPaymentScore">还款</th>
            <th width="3%" data-field="issuerDescriptionScore">融资</th>
            <th width="10%">操作</th>

        </tr>
    </thead>
</table>

三、绑定后端逻辑

因为，Bootstrap Table默认是使用了form表单的方式提交，其分页参数与查询参数都与我们的后端逻辑协议不一致。(官方就缺少这一部分的文档Fuck!!!!!)

所以，我们需要更具其协议做一个自定义的配置。

$(function() 
    $("#demo").bootstrapTable(
        url: "http://ydjr.dev.chengyiwm.com/goldman-mgr/listProduct",
        sortName: "prodId", //排序列  
        striped: true, //條紋行  
        sidePagination: "server", //服务器分页  
        clickToSelect: true, //选择行即选择checkbox  
        singleSelect: true, //仅允许单选  
        searchOnEnterKey: true, //ENTER键搜索  
        pagination: true, //启用分页  
        escape: true, //过滤危险字符  
        queryParams: getParams, //携带参数  
        method: "post", //请求格式  
        responseHandler: responseHandler,
    );

);


/**
 *  默认加载时携带参数
 * 
 *  将自带的param参数转化到cy的请求逻辑协议
 */
function getParams(params) 
    var query = $("#searchKey").val();
    console.log(JSON.stringify(params));
    return 
        head: 
            userId: "11154",
            skey: "6FC19FCE5D8DCF130954D8AE2CADB30A",
            platform: "pc",
            imei: "",
            appVersion: "",
            cityId: "",
            platformVersion: "",
            deviceId: "",
            channel: "",
            protoVersion: 1,
            isPreview: 2
        ,
        body: 
            'query': params.search,   // 搜索参数
            'start': params.offset,  // 分页开始位置
            'pageSize': params.limit, //每页多少条

        
    



/**
 * 获取返回的数据的时候做相应处理，让bootstrap table认识我们的返回格式
 * @param Object res
 */
function responseHandler(res) 
    return 
        "rows": res.body.listProduct, // 具体每一个bean的列表
        "total": res.body.totalCount  // 总共有多少条返回数据
    

Ok配置完成后给大家看看我们的显示效果