来自 计算机前端 2019-11-23 15:01 的文章
当前位置: 美高梅4858官方网站 > 计算机前端 > 正文

table使用指南详解,JS表格组件神器bootstrap

bootstrap table详细使用指南分享,供大家参考,具体内容如下

一、Bootstrap Table的引入

1、bootstrap-table简介

关于Bootstrap Table的引入,一般来说还是两种方法:

1.1、bootstrap table简介及特征:

1、直接下载源码,添加到项目里面来。由于Bootstrap Table是Bootstrap的一个组件,所以它是依赖Bootstrap的,我们首先需要添加Bootstrap的引用。

Bootstrap table是国人开发的一款基于 Bootstrap 的 jQuery 表格插件,通过简单的设置,就可以拥有强大的单选、多选、排序、分页,以及编辑、导出、过滤(扩展)等等的功能。目前在github上已经有2600多个Star,可见其受欢迎程度。其官方网站地址为:。里面可以下载使用所需的JS和CSS文件,以及参考文档和例子。

2、使用我们神奇的Nuget打开Nuget,搜索这两个包

  • 支持 Bootstrap 3 和 Bootstrap 2
  • 自适应界面
  • 固定表头
  • 非常丰富的配置参数
  • 直接通过标签使用
  • 显示/隐藏列
  • 显示/隐藏表头
  • 通过 AJAX 获取 JSON 格式的数据
  • 支持排序
  • 格式化表格
  • 支持单选或者多选
  • 强大的分页功能
  • 支持卡片视图
  • 支持多语言
  • 支持插件

Bootstrap已经是最新的3.3.5了,我们直接安装即可。

1.2、bootstrap table渲染数据到表格的方式:

而Bootstrap Table的版本竟然是0.4,这也太坑爹了。所以博主建议Bootstrap Table的包就直接在源码里面去下载吧。Bootstrap Table最新的版本好像是1.9.0。

Bootstrap-Table显示数据到表格的方式有两种,一种是客户端(client)模式,一种是服务器(server)模式

二、代码详解当然,组件引用进来了,使用就简单了,只不过这里面涉及很多细节需要我们处理,具体我们待会再说,先来看看使用方法。1、在cshtml页面引用相关组件,并定义好一个空的表格。

所谓客户端模式,指的是在服务器中把要显示到表格的数据一次性加载出来,然后转换成JSON格式传到要显示的界面中,在JavaWeb中可以保存在request中,然后转发到指定界面,在界面初始化的时候使用EL表达式获取,然后调用相关初始化的函数,将JSON字符串传进去即可显示。客户端模式较为简单,它是把数据一次性加载出来放到界面上,然后根据你设置的每页记录数,自动生成分页。当点击第二页时,会自动加载出数据,不会再向服务器发送请求。同时用户可以使用其自带的搜索功能,可以实现全局数据搜索。对于数据量较少的时候,可以使用这个方法。但是对于数据量大的系统,使用该方法会造成加载出一些很久之前的,用户不在关注的数据,使得加载速度变慢,增加了服务器的负担,浪费了资源。这时应该采用服务器模式。

@{ Layout = null;} BootStrap Table使用 @*1、Jquery组件引用*@  @*2、bootstrap组件引用*@   @*3、bootstrap table组件以及中文包的引用*@    @*4、页面Js文件的引用*@    查询条件      新增   修改   删除    

所谓服务器模式,指的是根据设定的每页记录数和当前要显示的页码,发送数据到服务器进行查询,然后再显示到表格中。该方法可以根据用户的需要动态的加载数据,节省了服务器的资源,但是不能使用其自带的全数据搜索功能。因为你加载的数据只是一页的数据,所以全数据搜索的范围也只在一页之中。
客户端模式较为简单,读者可根据官方文档和例子自行实践。这里主要介绍服务器模式,并可以实现带参数的查询。

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

2、bootstrap-table的引入

。当然Bootstrap table还提供了一种简介的用法,直接在table标签里面定义类似“data-...”等相关属性,就不用再js里面注册了,但博主觉得这种用法虽然简单,但不太灵活,遇到父子表等这些高级用法的时候就不太好处理了,所以咱们还是统一使用在js里面初始化的方式来使用table组件。2、Js初始化

关于Bootstrap Table的引入,一般来说还是两种方法:

$ { //1.初始化Table var oTable = new TableInit; //2.初始化Button的点击事件 var oButtonInit = new ButtonInit;});var TableInit = function () { var oTableInit = new Object(); //初始化Table oTableInit.Init = function () { $.bootstrapTable({ url: '/Home/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, //每页的记录行数 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, //是否显示父子表 columns: [{ checkbox: true }, { field: 'Name', title: '部门名称' }, { field: 'ParentName', title: '上级部门' }, { field: 'Level', title: '部门级别' }, { field: 'Desc', title: '描述' }, ] }); }; //得到查询的参数 oTableInit.queryParams = function  { var temp = { //这里的键的名字和控制器的变量名必须一直,这边改动,控制器也需要改成一样的 limit: params.limit, //页面大小 offset: params.offset, //页码 departmentname: $("#txt_search_departmentname").val(), statu: $.val() }; return temp; }; return oTableInit;};var ButtonInit = function () { var oInit = new Object(); var postdata = {}; oInit.Init = function () { //初始化页面上面的按钮事件 }; return oInit;};

2.1、直接使用免费且稳定的cdn服务:

表格的初始化也很简单,定义相关的参数即可。上面一些博主觉得重要的参数都加了注释,并且初始化Table必须的几个参数博主也用做了标记,如果你的表格也有太多的页面需求,直接用必须的参数就能解决。同样,在columns参数里面其实也有很多的参数需要设置,比如列的排序,对齐,宽度等等。这些博主觉得比较简单,不会涉及表格的功能,看看API就能搞定。3、在Controller里面对应的方法

如:Bootstrap中文网开源项目免费 CDN 服务,搜索自己所需要的较稳定的版本。

 public JsonResult GetDepartment(int limit, int offset, string departmentname, string statu) { var lstRes = new List(); for (var i = 0; i < 50; i++) { var oModel = new Department(); oModel.ID = Guid.NewGuid; oModel.Name = "销售部" + i ; oModel.Level = i.ToString(); oModel.Desc = "暂无描述信息"; lstRes.Add; } var total = lstRes.Count; var rows = lstRes.Skip.ToList(); return Json(new { total = total, rows = rows }, JsonRequestBehavior.AllowGet); }

图片 1

这里有一点需要注意:如果是服务端分页,返回的结果必须包含total、rows两个参数。漏写或错写都会导致表格无法显示数据。相反,如果是客户端分页,这里要返回一个集合对象到前端。

首先,Bootstrap 的所有 JavaScript 插件都依赖 jQuery,因此 jQuery 必须在 Bootstrap 之前引入,目前使用稳定版本jquery.1.12.1.js.

4、效果及说明

其次,Bootstrap Table是Bootstrap的一个组件,所以它是依赖Bootstrap的,我们首先需要添加Bootstrap的引用。直接在搜索框中搜索bootstrap,版本已经出来4的预览版,但还是建议使用比较稳定的Bootstrap3,目前最新的3.3.5。

还是贴几张效果图出来:

最后,就是Bootstrap Table的包了,直接在搜索框中搜索bootstrap-table,目前较好的版本为1.11.1,或者我们直接进到它的源码git clone https://github.com/wenzhixin/bootstrap-table,下载下来放到项目中即可。

三、问题小结

2.2、使用visual studio自带的包管理工具:Nuget

由于是从零开始开发的以上功能,博主遇到一个问题可以和园友们分享一下,这应该也是今天这篇想表达的重点。

NuGet的官方说明是:NuGet是一款Visual Studio的扩展,它可以简单的安装、升级开源库和工具。
官网地址:
从官网下载安装完成之后,就可以在vs中使用了。使用方法如下:
右键点击解决方案,如图:

1、上面说过,如果在js里面初始化的参数sidePagination: "server" 设置为在服务端分页,那么我们的返回值必须告诉前端总记录的条数和当前页的记录数,然后前端才知道如何分页。并且最重要的一点,这两个参数的名字必须为total和rows。最开始也不知道这个,写成了total和row,结果是请求可以进到后台的GetDepartment方法,返回值total和row也都有值,可是前端就是显示如下:

图片 2

找了好半天原因。原来是row写错了,应该写成rows。可能这也是前天园友遇到的问题的原因。

选择 “管理解决方案的NuGet的程序包”,出现如图:

2、第二个问题就是关于bootstrap页面样式的问题,我们使用过bootstrap的朋友应该知道,它里面所有的图标都是通过class = "glyphicon glyphicon-plus"这种方式去写的。按要求这样做了,可是新增、修改、删除前面的图标怎么都出不来。如下:

图片 3

怎么回事呢?然后各种百度,最后发现原来是fonts文件夹的问题。我们在新建一个MVC项目的时候,会自动创建一个fonts文件夹,里面内容如下:

依次搜索jquery ,bootstrap,bootstrap-table等放入本地文件夹。如果发现里面的版本较低,可以使用Bootstrap中文网开源项目免费 CDN 服务,获取最新的版本。

而我们的bootstrap.css是放在Content文件夹里面的,这样就导致找不到这些样式文件。最终通过谷歌浏览器查看控制台

3、代码详解

原来它自动去Content里面找fonts文件夹了。这下就好办了,把我们的fonts文件夹拷贝到Content下不就行了吗。呵呵,原来真是这样,问题顺利解决。

3.1、在html页面引用相关组件,并定义好一个空的表格。

3、关于中文。刚开始,没有引用

<!DOCTYPE html>
<html>
<head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta http-equiv="Cache-Control" content="no-cache">
 <title>登录信息</title>
 <!-- 1、Jquery组件引用-->
 <script src="../js/jquery.min.js?v=1.11.2"></script>
 <!-- 2、bootstrap组件引用-->
 <link href="../css/bootstrap.min.css?v=3.3.6" rel="stylesheet">
 <script src="../js/bootstrap.min.js?v=3.3.6"></script>
 <!-- 3、bootstrap-table组件引用-->
 <link href="../css/plugins/bootstrap-table/bootstrap-table.min.css?v=1.11.1" rel="stylesheet" />
 <script src="../js/plugins/bootstrap-table/bootstrap-table.min.js?v1.11.0"></script>
 <script src="../js/plugins/bootstrap-table/bootstrap-table-zh-CN.js?v1.11.0"></script><!--显示中文-->
 <!-- 4、其他-->
 <link href="../css/font-awesome.min.css" rel="stylesheet" />
 <link href="../css/style.min.css?v=4.1.0" rel="stylesheet">
 <link href="../css/customer_info.css?v=4.1.0" rel="stylesheet" />
 <script src="../js/plugins/layer/laydate/laydate.js"></script>
 <script src="../js/customer_info.js"></script>
</head>
<body class="gray-bg">
 <div class="wrapper wrapper-content" id="userLogin">
 <div id="dateSearch">
  <strong>开始日期: </strong>
  <input type="text" class="laydate-icon startDate" placeholder="开始日期">
  <strong>结束日期: </strong>
  <input type="text" class="laydate-icon endDate" placeholder="结束日期">
  <strong>用户ID: </strong>
  <input type="text" class="default-input form-control imuserid" placeholder="请输入用户id">
  <button type="button" class="btn btn btn-info search"> <i class="fa fa-search"></i> 搜索</button>
 </div>
 <div class="row" id="infoArea">
  <div class="col-sm-12" style="padding: 0 10px;">
  <ul class="nav nav-tabs" id="navList">
   <li data-name = "loginLogTab" class="active"><a data-toggle="tab" href="#loginLogTab"><i class="fa fa-user"></i>登录信息</a> </li>
   <li data-name = "receiveLogTab" class=""><a data-toggle="tab" href="#receiveLogTab"><i class="fa fa-briefcase"></i> 订购信息</a> </li>
   <li data-name = "socketInputTab" class=""><a data-toggle="tab" href="#socketInputTab"><i class="fa fa-briefcase"></i> 反馈信息</a> </li>
   <li data-name = "socketOutputTab" class=""><a data-toggle="tab" href="#socketOutputTab"><i class="fa fa-briefcase"></i> 出行信息</a> </li>
  </ul>
  <div class="tab-content" id="tabContent">
   <div id="toolbar" class="btn-group">
    <button id="btn_add" type="button" class="btn btn-info btn-sm rightSize">
    新增
    </button>
    <button id="btn_edit" type="button" class="btn btn-info btn-sm rightSize">
    修改
    </button>
    <button id="btn_delete" type="button" class="btn btn-info btn-sm rightSize">
    删除
    </button>
   </div>
   <div id="loginLogTab" class="tab-pane active">
   <div class="table-responsive">
    <table id="loginLog-table"></table>
   </div>
   </div>
   <div id="receiveLogTab" class="tab-pane">
   <div class="table-responsive">
    <table id="receiveLog-table"></table>
   </div>
   </div>
   <div id="socketInputTab" class="tab-pane">
   <div class="table-responsive">
    <table id="sockctInput-table"></table>
   </div>
   </div>
   <div id="socketOutputTab" class="tab-pane">
   <div class="table-responsive">
    <table id="sockctOutput-table"></table>
   </div>
   </div>
  </div>

  </div>
 </div>
 </div>
</body>
</html>

这个包,所以界面找不到记录是显示的是英文,如下:

引入需要的文件之后,我们最重要的就是定义一个空的table,如上的 <table></table>。
当然Bootstrap table还提供了另外两种简单的用法,直接通过$table.bootstrapTable({data: data}),具体参考form-data.html;
或者直接在table标签里面定义 <table data-toggle="table" data-url="../json/data1.json">,类似“data-...”等相关属性,具体参考table-style.html;这两种方法都不用在js里面注册就可以实现数据的加载,

后来也是查资料了解到,bootstrap table里面原来还有一个中文包,把它添加进来就好了。

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

4、第四点要说说表格自带的搜索功能,有上可知,在初始化表格的时候,通过设置search: true可以设置表格的搜索框出现并且可以进行模糊搜索。但是这个时候问题来了,我们采用的是服务端分页,每次返回到前台的只有本页的数据,这个时候我们再搜索的时候发现:搜索不了。这是什么原因呢?博主在谷歌里面调试bootstrap-table.js这个js发现里面有这样一段逻辑:

3.2、Js初始化

 BootstrapTable.prototype.onSearch = function  { var text = $.trim($.val; // trim search input if (this.options.trimOnSearch && $.val { $.val; } if (text === this.searchText) { return; } this.searchText = text; this.options.pageNumber = 1; this.initSearch(); this.updatePagination(); this.trigger; }; BootstrapTable.prototype.initSearch = function () { var that = this; if (this.options.sidePagination !== 'server') { var s = this.searchText && this.searchText.toLowerCase(); var f = $.isEmptyObject ? null : this.filterColumns; // Check filter this.data = f ? $.grep(this.options.data, function  { for  { if  { return false; } } return true; }) : this.options.data; this.data = s ? $.grep(this.data, function  { for  { key = $.isNumeric ? parseInt : key; var value = item[key], column = that.columns[getFieldIndex], j = $.inArray(key, that.header.fields); // Fix #142: search use formated data if (column && column.searchFormatter) { value = calculateObjectValue(column, that.header.formatters[j], [value, item, i], value); } var index = $.inArray(key, that.header.fields); if (index !== -1 && that.header.searchables[index] && (typeof value === 'string' || typeof value === 'number')) { if (that.options.strictSearch) { if .toLowerCase { return true; } } else { if .toLowerCase { return true; } } } } return false; }) : this.data; } };
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 = "<a href='#'>"+ res + "</a>";
 return html;
 }
 var operateFormatter = function (value, row, index) {//赋予的参数
 return [
  '<button class="btn btn-info btn-sm rightSize detailBtn" type="button"><i class="fa fa-paste"></i> 详情</button>',
  '<button class="btn btn-danger btn-sm rightSize packageBtn" type="button"><i class="fa fa-envelope"></i> 通知</button>'
 ].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);
  }
 });
 }

在initSearch方法里面,它有一个判断:if (this.options.sidePagination !== 'server') {......}也就是说,如果不是服务端分页,才进入检索,重写加载表格,否则压根就不会进入检索,这也就是为什么服务分页的时候,搜索会不起作用。博主试了下,换成客户端分页,确实可以搜索。呵呵,原来如此。其实这也很好里面,过滤本页的数据,意义不大。5、关于Bootstrap Table的排序,由于一般这种BS系统肯定会采用服务端分页,我们如果仅仅在js里面设置sortable和sortOrder等属性信息,表格是不会有效排序的。原因很简单,服务端分页的方式,排序本页数据意义不大。所以,一般的排序需要将排序方式和排序字段发送到后台,在后台排序比较合适。比如我们这里可以再参数里面增加两个:

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

oTableInit.queryParams = function  { var temp = { //这里的键的名字和控制器的变量名必须一直,这边改动,控制器也需要改成一样的 limit: params.limit, //页面大小 offset: params.offset, //页码 order: params.order, ordername: params.sort, departmentname: $("#txt_search_departmentname").val(), statu: $.val() }; return temp; };

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

五、总结在开发经历中,也使用Jqgrid、EasyUI等表格组件。相比而言,bootstrap Table有自己的优势:

3.3、页面效果图展示:

1、界面采用扁平化的风格,用户体验比较好,更好兼容各种客户端。这点也是最重要的。

图片 4

2、开源、免费。国人最喜欢的就是免费了。呵呵。

图片 5

3、相对Jqgrid、easyUI而言,比较轻量级。功能不能说最全面,但基本够用。

4、其他常用且高级功能

如果大家还想深入学习,可以点击这里进行学习,再为大家附两个精彩的专题:Bootstrap学习教程 Bootstrap实战教程 Bootstrap Table使用教程

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

最近新补充的一系列bootstrap基础教程,欢迎大家学习。

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

以上就是本文的全部内容,希望能够帮助大家更好的学习JS表格组件神器bootstrap table。

图片 6

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

效果如图:

本文由美高梅4858官方网站发布于计算机前端,转载请注明出处:table使用指南详解,JS表格组件神器bootstrap

关键词: