Erläuterung zur Verwendung von Plug-Ins in Bootstraptable zur Implementierung von Tabellenabfrage-, Paging- und Sortiervorgängen

In diesem Artikel wird hauptsächlich die Verwendung des Bootstraptable-Plug-Ins zum Implementieren von Abfrage-, Paging- und Sortiervorgängen für Tabellendatensätze vorgestellt. Freunde in Not können sich auf das Bootstrap-Tutorial beziehen.

Abfragen, Paging, Sortieren und andere Verarbeitungen von Tabellendatensätzen sind in der Geschäftssystementwicklung weit verbreitet. In der Webentwicklung können viele leistungsstarke Plug-Ins verwendet werden, um die Anforderungen zu erfüllen, und sind äußerst effizient. Um die Entwicklungseffizienz erheblich zu verbessern, stellt dieser Aufsatz Bootstrap-Table vor, ein sehr bekanntes Open-Source-Table-Plug-In, das in vielen Projekten weit verbreitet ist. Das Bootstrap-Table-Plugin bietet einen sehr umfangreichen Satz von Attributen, mit denen Abfragen, Paging, Sortieren, Kontrollkästchen, Festlegen von Anzeigespalten, Kartenansicht, Master-Slave-Tabellenanzeige, Zusammenführungsspalten, Internationalisierungsverarbeitung und andere Verarbeitungsfunktionen implementiert werden können. und das Plug-in Gleichzeitig bietet es auch einige gute Erweiterungsfunktionen, wie z. B. das Verschieben von Zeilen, das Verschieben von Spaltenpositionen und andere spezielle Funktionen. Das Plug-in kann mithilfe der HTML5-basierten Daten-*-Attributkennung oder festgelegt werden Es kann mit Javascript eingestellt werden, was sehr praktisch ist. Dieser Aufsatz stellt die Anwendung des Bootstrap-Table-Plug-Ins in meinem aktuellen Projekt vor und fasst die Erfahrungen im Umgang mit Problemen zusammen, die bei der entsprechenden Verwendung auftreten.

1. Einführung in Bootstrap-Table-Ressourcen und -Nutzung

Bootstrap-Table bietet zwei Möglichkeiten, Daten in der Tabelle anzuzeigen: eine im Client-Modus und eine im Server-Modus Modus.

Der sogenannte Client-Modus bezieht sich auf das gleichzeitige Laden der in der Tabelle anzuzeigenden Daten auf den Server, die anschließende Konvertierung in das JSON-Format und die Übertragung an die anzuzeigende Schnittstelle. Der Client-Modus ist relativ einfach: Laden Sie die Daten auf einmal, stellen Sie sie auf die Schnittstelle und generieren Sie dann automatisch Paging entsprechend der von Ihnen festgelegten Anzahl von Datensätzen pro Seite. Beim Anklicken der zweiten Seite werden die Daten automatisch geladen und es werden keine weiteren Anfragen an den Server gesendet. Gleichzeitig können Benutzer eine eigene Suchfunktion verwenden, um eine vollständige Datensuche zu erreichen. Diese Methode kann verwendet werden, wenn die Datenmenge gering ist.

Der sogenannte Servermodus bezieht sich auf das Senden von Daten an den Server zur Abfrage basierend auf der eingestellten Anzahl von Datensätzen pro Seite und der aktuell anzuzeigenden Seitenzahl und deren anschließende Anzeige in der Tabelle. Diese Methode kann Daten dynamisch entsprechend den Benutzeranforderungen laden und so Serverressourcen sparen, kann jedoch nicht ihre eigene vollständige Datensuchfunktion verwenden.

Bootstrap-table ist ein auf Boosttrap basierendes Plug-In. Wenn Sie es verwenden, müssen Sie also Bootstrap-Skripte und -Stile einführen.

Wenn die relevanten Dateien nicht in unserem Projekt eingeführt werden, müssen Sie diese Stil- und Skriptdateien wie unten gezeigt einführen.

<link rel="stylesheet" href="bootstrap.min.css" rel="external nofollow" >
<script src="jquery.min.js"></script>
<script src="bootstrap.min.js"></script>

Der oben genannte Inhalt muss jedoch verfügbar sein, wenn wir das Projekt entwickeln, daher konzentrieren wir uns weiterhin auf die Importdateien, die für die Verwendung dieses Plug-Ins erforderlich sind.

Einführung in die CSS-Datei

<link rel="stylesheet" href="bootstrap-table.css" rel="external nofollow" >

Einführung in die Skriptdatei

<script src="bootstrap-table.js"></script>
<--汉化文件，放在 bootstrap-table.js 后面-->
<script src="bootstrap-table-zh-CN.js"></script>

Wenn wir ein auf MVC basierendes System entwickeln, sind die CSS- und JS-Codes im Allgemeinen so initialisiert in BundleConfig.cs, wie unten gezeigt

Die Verwendung der Bootstrap-Tabelle auf der Seite kann in zwei Typen unterteilt werden, die rein in HTML5 geschrieben sind, und jeder Parameter wird durch data-* angegeben Es gibt zwei Arten von Attributeinstellungen, und eine davon ist die HTML+JS-Methode, um flexible Einstellungen zu erreichen.

Wenn wir den HTML-Code mit dem HTML5-Logo initialisieren, ist es der folgende Code.

<table data-toggle="table" data-url="data1.json">
 <thead>
  <tr>
   <th data-field="id">Item ID</th>
   <th data-field="name">Item Name</th>
   <th data-field="price">Item Price</th>
  </tr>
 </thead>
</table>

Wenn wir JS-Code zum Initialisieren des Tabellen-Plug-Ins verwenden, müssen wir nur ein Tabellenobjekt in HTML deklarieren, wie im folgenden Code gezeigt.

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

Dann ist die einfache JS-Code-Initialisierung wie folgt

$('#table').bootstrapTable({
 url: 'data1.json',
 columns: [{
  field: 'id',
  title: 'Item ID'
 }, {
  field: 'name',
  title: 'Item Name'
 }, {
  field: 'price',
  title: 'Item Price'
 }, ]
});

Tatsächlich ist die von uns verwendete JS-Konfigurationsfunktion jedoch definitiv viel komplizierter als diese Der Schnittstelleneffekt ist die tatsächliche Tabellendatenanzeige.

2. Detaillierte Verwendung der Bootstrap-Tabelle

1) Die gesamte JS-Attributkonfiguration

ist in Im Bild oben verwenden wir JS, um den Tabelleninhalt zu initialisieren.

 var $table;
  //初始化bootstrap-table的内容
  function InitMainTable () {
   //记录页面bootstrap-table全局变量$table，方便应用
   var queryUrl = '/TestUser/FindWithPager?rnd=' + Math.random()
   $table = $('#grid').bootstrapTable({
    url: queryUrl,      //请求后台的URL（*）
    method: 'GET',      //请求方式（*）
    //toolbar: '#toolbar',    //工具按钮用哪个容器
    striped: true,      //是否显示行间隔色
    cache: false,      //是否使用缓存，默认为true，所以一般情况下需要设置一下这个属性（*）
    pagination: true,     //是否显示分页（*）
    sortable: true,      //是否启用排序
    sortOrder: "asc",     //排序方式
    sidePagination: "server",   //分页方式：client客户端分页，server服务端分页（*）
    pageNumber: 1,      //初始化加载第一页，默认第一页,并记录
    pageSize: rows,      //每页的记录行数（*）
    pageList: [10, 25, 50, 100],  //可供选择的每页的行数（*）
    search: false,      //是否显示表格搜索
    strictSearch: true,
    showColumns: true,     //是否显示所有的列（选择显示的列）
    showRefresh: true,     //是否显示刷新按钮
    minimumCountColumns: 2,    //最少允许的列数
    clickToSelect: true,    //是否启用点击选中行
    //height: 500,      //行高，如果没有设置height属性，表格自动根据记录条数觉得表格高度
    uniqueId: "ID",      //每一行的唯一标识，一般为主键列
    showToggle: true,     //是否显示详细视图和列表视图的切换按钮
    cardView: false,     //是否显示详细视图
    detailView: false,     //是否显示父子表
    //得到查询的参数
    queryParams : function (params) {
     //这里的键的名字和控制器的变量名必须一直，这边改动，控制器也需要改成一样的
     var temp = { 
      rows: params.limit,       //页面大小
      page: (params.offset / params.limit) + 1, //页码
      sort: params.sort,  //排序列名 
      sortOrder: params.order //排位命令（desc，asc） 
     };
     return temp;
    },
    columns: [{
     checkbox: true, 
     visible: true     //是否显示复选框 
    }, {
     field: 'Name',
     title: '姓名',
     sortable: true
    }, {
     field: 'Mobile',
     title: '手机',
     sortable: true
    }, {
     field: 'Email',
     title: '邮箱',
     sortable: true,
     formatter: emailFormatter
    }, {
     field: 'Homepage',
     title: '主页',
     formatter: linkFormatter
    }, {
     field: 'Hobby',
     title: '兴趣爱好'
    }, {
     field: 'Gender',
     title: '性别',
     sortable: true
    }, {
     field: 'Age',
     title: '年龄'
    }, {
     field: 'BirthDate',
     title: '出生日期',
     formatter: dateFormatter
    }, {
     field: 'Height',
     title: '身高'
    }, {
     field: 'Note',
     title: '备注'
    }, {
     field:'ID',
     title: '操作',
     width: 120,
     align: 'center',
     valign: 'middle',
     formatter: actionFormatter
    }, ],
    onLoadSuccess: function () {
    },
    onLoadError: function () {
     showTips("数据加载失败！");
    },
    onDblClickRow: function (row, $element) {
     var id = row.ID;
     EditViewById(id, 'view');
    },
   });
  };

Die Konfigurationseigenschaften des obigen JS-Codes sind grundsätzlich auskommentiert, was relativ einfach zu verstehen ist.

2) Abfrage und Paging

Das Paging von Tabellendaten wird hier gemäß den Suchbedingungen vom Server zurückgegeben und die Sortiermethode verwendet Parameter sind die an den Server übermittelten Parameter. Darüber hinaus sehen wir, dass die URL-Adressschnittstelle für die Rückgabe von Daten FindWithPager ist. Schauen wir uns an, wie diese MVC-Controller-Methode die Datenrückgabe verarbeitet.

 //得到查询的参数
    queryParams : function (params) {
     //这里的键的名字和控制器的变量名必须一直，这边改动，控制器也需要改成一样的
     var temp = { 
      rows: params.limit,       //页面大小
      page: (params.offset / params.limit) + 1, //页码
      sort: params.sort,  //排序列名 
      sortOrder: params.order //排位命令（desc，asc） 
     };
     return temp;
    },

Der obige Code verarbeitet zwei Teile der Objektinformationen, der eine ist das Paging von Entitätsklasseninformationen und der andere das Sortieren von Informationen. Anschließend ruft er Datensätze basierend auf diesen Bedingungen ab und gibt so etwas wie

{total :22,rows :{}}

/// <summary>
  /// 根据条件查询数据库,并返回对象集合(用于分页数据显示)
  /// </summary>
  /// <returns>指定对象的集合</returns>
  public override ActionResult FindWithPager()
  {
   //检查用户是否有权限，否则抛出MyDenyAccessException异常
   base.CheckAuthorized(AuthorizeKey.ListKey);

   string where = GetPagerCondition();
   PagerInfo pagerInfo = GetPagerInfo();
   var sort = GetSortOrder();

   List<TestUserInfo> list = null;
   if (sort != null && !string.IsNullOrEmpty(sort.SortName))
   {
    list = baseBLL.FindWithPager(where, pagerInfo, sort.SortName, sort.IsDesc);
   }
   else
   {
    list = baseBLL.FindWithPager(where, pagerInfo);
   } 

   //Json格式的要求{total:22,rows:{}}
   //构造成Json的格式传递
   var result = new { total = pagerInfo.RecordCount, rows = list };
   return ToJsonContent(result);
  }

JSON-Datensatz im Format.                                                                                                     

 /// <summary>
  /// 获取排序的信息
  /// </summary>
  /// <returns></returns>
  protected SortInfo GetSortOrder()
  {
   var name = Request["sort"];
   var order = Request["sortOrder"];
   return new SortInfo(name, order);
  }

最后就是具体实现具体条件、具体页码、具体排序条件下的数据记录了，这部分可以根据自己的要求实现逻辑，这里只是给出一个封装好的处理调用即可。

baseBLL.FindWithPager(where, pagerInfo, sort.SortName, sort.IsDesc);

实际情况下，我们列表的展示，一般需要使用不同的条件进行数据的查询的，虽然这个Bootstrap-table控件提供了一个默认的查询按钮，不过一般是在客户端分页的情况下使用，而且略显简单，我们一般使用自己查询条件进行处理，如下界面所示。

或者如下的

那么这样对于上面的js属性就需要调整下接受查询条件参数queryParams 了            

 //得到查询的参数
    queryParams : function (params) {
     //这里的键的名字和控制器的变量名必须一直，这边改动，控制器也需要改成一样的
     var temp = { 
      rows: params.limit,       //页面大小
      page: (params.offset / params.limit) + 1, //页码
      sort: params.sort,  //排序列名 
      sortOrder: params.order //排位命令（desc，asc） 
     };
     return temp;
    },

对于自定义查询条件，我们可以用下面的常规方式增加参数，如下所示

但是查询条件的参数我们不方便一一设置，我们想通过一种较为快捷的方式来处理，那么就需要对这个处理方式进行一个特别的修改了，首先添加一个扩展函数来处理表单的条件

 //自定义函数处理queryParams的批量增加
  $.fn.serializeJsonObject = function () {
   var json = {};
   var form = this.serializeArray();
   $.each(form, function () {
    if (json[this.name]) {
     if (!json[this.name].push) {
      json[this.name] = [json[this.name]];
     }
     json[this.name].push();
    } else {
     json[this.name] = this.value || '';
    }
   });
   return json;
  }

然后我们就可以批量处理表单的查询条件了        

 queryParams : function (params) {
     //这里的键的名字和控制器的变量名必须一直，这边改动，控制器也需要改成一样的
     var temp = $("#ffSearch").serializeJsonObject();
     temp["rows"] = params.limit;      //页面大小
     temp["page"] = (params.offset / params.limit) + 1; //页码
     temp["sort"] = params.sort;       //排序列名
     temp["sortOrder"] = params.order;     //排位命令（desc，asc） 

     //特殊格式的条件处理
     temp["WHC_Age"] = $("#WHC_Age").val() + "~" + $("#WHC_Age2").val();
     temp["WHC_BirthDate"] = $("#WHC_BirthDate").val() + "~" + $("#WHC_BirthDate2").val();

     return temp;
    },

然后后端统一按照逻辑处理查询参数即可。

3）格式化输出函数及其他

对于上面JS的配置信息，我们再来回顾一下，例如对于数据转义函数，可以格式化输出的内容的，如下界面代码。

格式化的数据转义函数如下，主要就是根据内容进行格式化输出的JS函数，好像是需要放在一个文件内。

 //连接字段格式化
  function linkFormatter(value, row, index) {    
   return "<a href=&#39;" + value + "&#39; title=&#39;单击打开连接&#39; target=&#39;_blank&#39;>" + value + "</a>";
  }
  //Email字段格式化
  function emailFormatter(value, row, index) {
   return "<a href=&#39;mailto:" + value + "&#39; title=&#39;单击打开连接&#39;>" + value + "</a>";
  }
  //性别字段格式化
  function sexFormatter(value) {
   if (value == "女") { color = &#39;Red&#39;; }
   else if (value == "男") { color = &#39;Green&#39;; }
   else { color = &#39;Yellow&#39;; }

   return &#39;<p style="color: &#39; + color + &#39;">&#39; + value + &#39;</p>&#39;;
  }

另外，我们看到行记录的最后增加了几个操作按钮，方便对当前记录的查看、编辑和删除操作，如下效果图所示。

这部分我们也是通过格式化函数进行处理的

 //操作栏的格式化
  function actionFormatter(value, row, index) {
   var id = value;
   var result = "";
   result += "<a href=&#39;javascript:;&#39; class=&#39;btn btn-xs green&#39; onclick=\"EditViewById(&#39;" + id + "&#39;, view=&#39;view&#39;)\" title=&#39;查看&#39;><span class=&#39;glyphicon glyphicon-search&#39;></span></a>";
   result += "<a href=&#39;javascript:;&#39; class=&#39;btn btn-xs blue&#39; onclick=\"EditViewById(&#39;" + id + "&#39;)\" title=&#39;编辑&#39;><span class=&#39;glyphicon glyphicon-pencil&#39;></span></a>";
   result += "<a href=&#39;javascript:;&#39; class=&#39;btn btn-xs red&#39; onclick=\"DeleteByIds(&#39;" + id + "&#39;)\" title=&#39;删除&#39;><span class=&#39;glyphicon glyphicon-remove&#39;></span></a>";
   return result;
  }

 

如果我们需要双击弹出编辑界面的层，我们可以处理表格的双击事件，如下代码所示。

      onDblClickRow: function (row, $element) {
          var id = row.ID;
          EditViewById(id, 'view');
        },

如果我们需要设置行的不同的样式展示，可以通过增加rowStyle的JS处理函数即可，如下代码所示

       rowStyle: function (row, index) { //设置行的特殊样式
          //这里有5个取值颜色['active', 'success', 'info', 'warning', 'danger'];
          var strclass = "";
          if (index == 0) {
            strclass = "warning";
          }
          return { classes: strclass }
        }

 对于表格记录的获取，我们可以通过下面的代码进行获取：$table.bootstrapTable('getSelections')

      var rows = $table.bootstrapTable('getSelections');
      if (rows.length > 0) {
        ID = rows[0].ID;
      }

如果是多条记录的处理，例如删除记录

    //实现删除数据的方法
    function Delete() {
      var ids = "";//得到用户选择的数据的ID
      var rows = $table.bootstrapTable('getSelections');
      for (var i = 0; i < rows.length; i++) {
        ids += rows[i].ID + &#39;,&#39;;
      }
      ids = ids.substring(0, ids.length - 1);
      DeleteByIds(ids);
    }

如果需要设置显示列显示，如下界面所示

以及排序处理

这些需要在JS代码开启相关的属性即可。

还有就是一种CardView的卡片视图格式，如下所示。

另外一种是父子表的展开明细的格式，如下所示

 以上就是bootstrap-table插件在我实际项目中的应用情况，基本上对JS各个属性的使用进行了一些介绍了，具体的应用我们可以参考它的文档，获取对应属性、方法、事件的详细说明，这样我们就可以更加详细的应用这个插件的各种功能了。

Das obige ist der detaillierte Inhalt vonErläuterung zur Verwendung von Plug-Ins in Bootstraptable zur Implementierung von Tabellenabfrage-, Paging- und Sortiervorgängen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!