之前一直在调研我们的管理后台使用的表格控件,查询到 : 的Bootstrap Table 感觉挺不错,但是由于官方的文档不是怎么的完善,导致自己的网络数据请求一直没有通过。
今天终于调试通过,在这里与大家分享一下。
一、相关的配置文件引入
<!-- jQuery文件。务必在bootstrap.min.js 之前引入 --> <script src="https://cdn.bootcss.com/jquery/1.11.3/jquery.min.js"></script> <link href="https://cdn.bootcss.com/bootstrap/3.3.5/css/bootstrap.min.css"> <script src="https://cdn.bootcss.com/bootstrap/3.3.5/js/bootstrap.min.js"></script> <!-- bootstrap table --> <link href="https://cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table.min.css"> <script src="https://cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table.min.js"></script> <script src="https://cdn.bootcss.com/bootstrap-table/1.11.0/bootstrap-table-locale-all.js"></script> <script src="https://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="https://cdn.bootcss.com/FileSaver.js/2014-11-29/FileSaver.min.js"></script>
注意!!!!! 这里的 tableExport.js并不是 bootcdn上的tableExport,使用的时候注意看作者,不到会导致无法导出excel
二、编写表头和工具栏
其实整个表头的编写非常简单,只需要简单的几个配置就好。
注意,把每一个bean的属性书写在th中
注意绑定工具栏
可以参考如下配置
<!-- 工具栏的按钮,可以自定义事件 --> <div> <button type="button"> <i></i> </button> <button type="button"> <i></i> </button> <button type="button"> <i></i> </button> </div> <table 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 data-field="prodId">产品Id</th> <th data-field="nameOfProduct">产品名称</th> <th data-field="categoryId">产品类别</th> <th data-field="domicileOfCapital">资本类型</th> <th data-field="underwriter">发行机构</th> <th data-field="managementInstitution">基金公司</th> <th data-field="managementInstitution2">管理机构</th> <th data-field="flag">角标</th> <th data-field="beginTime">上线时间</th> <th data-field="endTime">下线时间</th> <th data-field="status">发布状态</th> <th data-field="fundRaisingStatus">募集状态</th> <th data-field="totalScore">打分</th> <th data-field="modesOfGuaranteeScore">担保</th> <th data-field="invsetmentTargetScore">投资</th> <th data-field="underwriterScore">发行</th> <th data-field="sourceOfPaymentScore">还款</th> <th data-field="issuerDescriptionScore">融资</th> <th>操作</th> </tr> </thead> </table>
三、绑定后端逻辑
因为,Bootstrap Table默认是使用了form表单的方式提交,其分页参数与查询参数都与我们的后端逻辑协议不一致。(官方就缺少这一部分的文档)
所以,我们需要更具其协议做一个自定义的配置。
$(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配置完成后给大家看看我们的显示效果:
如果大家还想深入学习,可以点击这里进行学习,再为大家附3个精彩的专题: