JS表格组件神器bootstraptable怎么用

引入需要的文件之后，我们最重要的就是定义一个空的table，如上的

但博主觉得这种用法虽然简单，但不太灵活，所以咱们还是统一使用在js里面初始化的方式来使用table组件。

3.2、Js初始化

var queryParams = function (params) {
 var param = {
  pageIndex: Math.ceil(params.offset / params.limit) + 1,
  pageSize: params.limit,
  order: params.order,
  ordername: params.sort,
  startDateTime: $("#dateSearch .startDate").val(),
  endDateTime: $("#dateSearch .endDate").val(),
  search: $("#dateSearch .imuserid").val()
 };
 return param;
 }
 
 var responseHandler = function (e) {
 console.log(e);
 if (e.data && e.data.length > 0) {
  return { "rows": e.data, "total": e.count };
 }
 else {
  return { "rows": [], "total": 0 };
 }
 
 }
 var uidHandle = function (res) {
 var html = ""+ res + "";
 return html;
 }
 var operateFormatter = function (value, row, index) {//赋予的参数
 return [
  ' 详情',
  ' 通知'
 ].join('');
 }
 self.dataInit = function (name) {
 var url, columns, tableName;
 switch (name) {
  case 'loginLogTab':
  tableName = "loginLog-table";
  columns = [
   {
   checkbox: true
   },
   {
   field: 'uid',
   title: '用户编号',
   align: 'center',
   formatter: uidHandle,//自定义方法设置uid跳转链接
   width:300
   }, {
   field: 'name',
   title: '姓名',
   align: 'center',
   sortable:false //本列不可以排序
   }, {
   field: 'sex',
   title: '性别',
   align: 'center'
   }, {
   field: 'age',
   title: '年龄',
   align: 'center',
   sortable: true,
   clickToSelect: false,
   sortName: "age",
   order:"asc"
   }, {
   field: 'area',
   title: '户籍所在地',
   align: 'left',
   halign:'center' //设置表头列居中对齐
   }, {
   field: 'loginWay',
   title: '登录方式',
   align: 'center'
   }, {
   field: 'status',
   title: '状态',
   align: 'center'
   },{
   field: 'createTime',
   title: '登录时间',
   align: 'center',
   width: 90
   }, {
   field: 'orderService',
   title: '购买服务',
   align: 'center'
   }, {
   field: 'connectorIP',
   title: '连接器IP',
   align: 'center'
   }, {
   field: 'connectorPort',
   title: '连接器端口',
   align: 'center'
   }, {
   field: 'operate',
   title: '操作',
   align: 'center',
   valign: 'middle',
   formatter: operateFormatter //自定义方法，添加操作按钮
   }
  ];
  break;
  case 'receiveLogTab':
  //省略
  break;
  case 'socketInputTab':
  //省略
  break;
  case 'socketOutputTab':
  //省略
  break;
 }
 $('#' + tableName).empty();
 $('#' + tableName).bootstrapTable('destroy').bootstrapTable({
  url: '../data/login_info2.json', //url一般是请求后台的url地址,调用ajax获取数据。此处我用本地的json数据来填充表格。
  method: "get",   //使用get请求到服务器获取数据
  dataType: "json",
  contentType: 'application/json,charset=utf-8',
  toolbar: "#toolbar",  //一个jQuery 选择器，指明自定义的toolbar 例如:#toolbar, .toolbar.
  uniqueId: "id",   //每一行的唯一标识，一般为主键列
  height: document.body.clientHeight-165, //动态获取高度值，可以使表格自适应页面
  cache: false,   // 不缓存
  striped: true,   // 隔行加亮
  queryParamsType: "limit",  //设置为"undefined",可以获取pageNumber，pageSize，searchText，sortName，sortOrder 
      //设置为"limit",符合 RESTFul 格式的参数,可以获取limit, offset, search, sort, order 
  queryParams: queryParams,
  sidePagination: "server",  //分页方式：client客户端分页，server服务端分页（*）
  // sortable: true,   //是否启用排序;意味着整个表格都会排序
  sortName: 'uid',   // 设置默认排序为 name
  sortOrder: "asc",   //排序方式
  pagination: true,   //是否显示分页（*）
  search: true,   //是否显示表格搜索，此搜索是客户端搜索，不会进服务端，所以，个人感觉意义不大
  strictSearch: true,
  showColumns: true,   //是否显示所有的列
  showRefresh: true,   //是否显示刷新按钮
  showToggle:true,   //是否显示详细视图和列表视图
  clickToSelect: true,  //是否启用点击选中行
  minimumCountColumns: 2,  //最少允许的列数 clickToSelect: true, //是否启用点击选中行
  pageNumber: 1,   //初始化加载第一页，默认第一页
  pageSize: 10,   //每页的记录行数（*）
  pageList: [10, 25, 50, 100], //可供选择的每页的行数（*）
  paginationPreText: "Previous",
  paginationNextText: "Next",
  paginationFirstText: "First",
  paginationLastText: "Last",
  responseHandler: responseHandler,
  columns: columns,
  onLoadSuccess: function (data) { //加载成功时执行
  console.log(data);
  },
  onLoadError: function (res) { //加载失败时执行
  console.log(res);
  }
 });
 }

表格的初始化也很简单，定义相关的参数即可。上面一些博主觉得重要的参数都加了注释，如果你的表格也有太多的页面需求，直接用必须的参数就能解决。

同样，在columns参数里面其实也有很多的参数需要设置，比如列的排序，对齐，宽度等等。这些博主觉得比较简单，不会涉及表格的功能，看看API就能搞定。

3.3、页面效果图展示：

4、其他常用且高级功能

4.1、实现表格奇偶行，背景颜色隔行显示;

单一的表格数据显示，看上去有些单调。通过设置表格奇偶行背景颜色隔行显示，会让表格更加生动。实际应用中经常会遇到。实现方法通过添加列方法,如图：

var rowStyle = function (row, index) {
 var classes = ['success', 'info'];
 if (index % 2 === 0) {//偶数行
 return { classes: classes[0]};
 } else {//奇数行
 return {classes: classes[1]};
 }
}

效果如图：

4.2、实现表格行列合并;

表格的行列合并功能不用引用其他的js文件，只需要在html页面使用table的colspan和rowspan即可实现。

data-url="../data/login_info.json">
 

要添加操作按钮和奇偶行背景颜色隔行显示，需要添加相应的js方法，如下：

function operateFormatter(value, row, index) {//赋予的参数
 return [
 ' 详情',
 ' 通知'
 ].join('');
}
 
var rowStyle = function (row, index) {
 var classesArr = ['success', 'info'];
 if (index % 2 === 0) {//偶数行
 return { classes: classesArr[0] };
 } else {//奇数行
 return { classes: classesArr[1] };
 }
}
window.operateFormatter = operateFormatter;
window.rowStyle = rowStyle;

效果如图：

5、遇到的问题及解决方法

5.1、当请求返回的数据结果不是固定的“total”,"rows"的格式时，如何渲染表格数据？

我们运用$('#' + tableName).bootstrapTable({ url: '../data/login_info.json'}),请求json数据，必须要求json数据格式为固定的key值，即必须按照“total”,"rows"的格式才能填充数据到表格，如图所示：

但是，当接口返回的数据格式，不是固定的“total”,"rows"时，我们需要用到一个转换函数responseHandler，将数据指引到“total”,"rows"上去。

即用login_info2.json和参数responseHandler实现数据填充。
login_info2.json的数据格式，如图：

添加的responseHandler的方法，如图：

将返回结果通过方法引导，也能实现数据的填充。

5.2、Bootstrap Table自带的搜索功能，在服务器模式和客户端模式的应用说明：

由于实际应用中，一般请求服务端，返回的数据会很多，所以一般都会用服务器模式加载数据。故通过 search: true显示的内部模糊匹配功能不常用。当然服务器模式加载的数据也可以实现搜索功能，即将数据传入后台，后台处理之后返回前端。

但是如果你需要对多个字段进行模糊匹配，那么就意味着你的后台需要去对多个数据字段进行like操作，这样查询效率肯定低下。所以，如果需要模糊匹配的字段很多，这个search在实际项目中是用不上的。综上，博主还是觉得只有在客户端分页的时候，这个搜索的作用比较明显。

var queryParams = function (params) {
 var param = {
  pageIndex: Math.ceil(params.offset / params.limit) + 1,
  pageSize: params.limit,
  search:$("#dateSearch .imuserid").val()
 };
 return param;
 }

5.3、Bootstrap Table的排序，在服务器模式和客户端模式的应用说明：

在客户端模式时，排序功能有效。在服务器模式下，通过 sortable: true所设置的排序功能作用也不大，因为它只会排序当前页，不会排序所有的数据；服务器模式要实现排序功能，需要添加排序字段order和ordername给后台，后台处理之后返回前端。

var queryParams = function (params) {
 var param = {
 pageIndex: Math.ceil(params.offset / params.limit) + 1,
 pageSize: params.limit,
 order: params.order,
 ordername: params.sort
 };
 return param;
}

5.4、关于通过“get”方式请求本地.json文件时出现中文乱码的问题：

在请求本地login_info2.json数据时，请求方式method:'get',设置为“post”时，出现“405”报错；同时，我发现从json文件请求的数据，返回到页面时，出现中文乱码的情况；但是页面上已经设置了，同时ajax请求时，也设置了内容返回的字符编码：contentType: 'application/json,charset=utf-8',但还是出现乱码，经过网上查找，找到解决方法是：

记事本打开json文件，另存为，将编码选择为utf-8，存储替换原来的文件就行了。如图：

以上是“JS表格组件神器bootstrap table怎么用”这篇文章的所有内容，感谢各位的阅读！相信大家都有了一定的了解，希望分享的内容对大家有所帮助，如果还想学习更多知识，欢迎关注创新互联行业资讯频道！