DIV CSS 佈局教程網

Bootstrap Table 進階玩法:父子表、行列拖曳排序與每欄篩選
編輯:關於JavaScript     

Bootstrap Table 是個輕量而功能密度極高的表格元件,單選、多選、排序、分頁、欄位顯示切換、固定表頭捲動、響應式版面、AJAX 載入 JSON、卡片檢視樣樣都有。本篇跳過入門,直接談三個實務上很常被要求、文件中卻得翻半天才找到的功能:父子表、拖曳排序、以及每個欄位各自的篩選框。

先看成果

父子表

列的拖曳排序

排序前:

把某一列拖到最前面:

欄位的拖曳排序

一、父子表:detailView 的用法

原理其實很單純。初始化時把 detailView 設為 true,每一列前面就會出現「+」號,點它就觸發展開事件,我們在事件裡把子表格塞進去。

$("#tb_powerset").bootstrapTable({
    url: '/api/MenuApi/GetParentMenu',
    method: 'get',
    detailView: true,          // 開啟父子表
    pageSize: 10,
    pageList: [10, 25],
    columns: [
        { field: 'MENU_NAME',  title: '菜單名稱' },
        { field: 'MENU_URL',   title: '菜單網址' },
        { field: 'PARENT_ID',  title: '父級菜單' },
        { field: 'MENU_LEVEL', title: '菜單級別' }
    ],
    onExpandRow: function (index, row, $detail) {
        oInit.InitSubTable(index, row, $detail);
    }
});

展開事件的回呼有三個參數,其中第三個最關鍵:

  • index:父表目前這列的索引。
  • row:父表目前這列的 JSON 資料。
  • $detail:展開後新增那一列裡的 td 元素——子表格就是要掛在它裡面。
oInit.InitSubTable = function (index, row, $detail) {
    var parentid = row.MENU_ID;
    var cur_table = $detail.html('<table></table>').find('table');
    $(cur_table).bootstrapTable({
        url: '/api/MenuApi/GetChildrenMenu',
        method: 'get',
        queryParams: { strParentID: parentid },
        ajaxOptions: { strParentID: parentid },
        clickToSelect: true,
        detailView: true,        // 子表也開父子表,就能無限層級
        uniqueId: "MENU_ID",
        pageSize: 10,
        pageList: [10, 25],
        columns: [
            { checkbox: true },
            { field: 'MENU_NAME',  title: '菜單名稱' },
            { field: 'MENU_URL',   title: '菜單網址' },
            { field: 'PARENT_ID',  title: '父級菜單' },
            { field: 'MENU_LEVEL', title: '菜單級別' }
        ],
        onExpandRow: function (i, r, $Subdetail) {
            oInit.InitSubTable(i, r, $Subdetail);   // 遞迴下去
        }
    });
};

重點就兩個:用 $detail.html('<table></table>') 生出一個空表格,再對它呼叫 bootstrapTable()。因為子表也開了 detailView 並遞迴呼叫自己, theoretically 可以有無限層級的展開。

二、列的拖曳排序

額外引入兩個檔案:

<script src="~/Content/jquery-ui-1.11.4.custom/external/jquery.tablednd.js"></script>
<script src="~/Content/bootstrap-table/extensions/reorder-rows/bootstrap-table-reorder-rows.js"></script>

表格標籤上加兩個屬性:

<table id="tb_order" data-use-row-attr-func="true" data-reorderable-rows="true"></table>

JavaScript 初始化完全不用改,功能就有了。

三、欄位的拖曳排序

需要引入的資源多了一些:

<script src="~/Content/bootstrap-table/extensions/reorder-columns/bootstrap-table-reorder-columns.js"></script>
<link rel="stylesheet" href="../assets/examples.css">
<link rel="stylesheet" href="https://rawgit.com/akottr/dragtable/master/dragtable.css">
<script src="https://code.jquery.com/ui/1.11.4/jquery-ui.js"</script>
<script src="https://rawgit.com/akottr/dragtable/master/jquery.dragtable.js"</script>

標籤上加一個屬性即可:

<table id="tb_departments" data-reorderable-columns="true"</table>

四、每個欄位獨立篩選

原本以為這種逐欄篩選只支援前端分頁,查了文件才發現確實有現成擴充,而且篩選條件會一起送到後端。

引入擴充:

<script src="~/Content/bootstrap-table/extensions/filter-control/bootstrap-table-filter-control.js"</script>

在表頭直接宣告篩選控件型態,select 是下拉清單,input 是文字框:

<table id="tb_roles" data-filter-control="true">
  <thead>
    <tr>
      <th data-field="ROLE_NAME"       data-filter-control="select">角色名稱</th>
      <th data-field="DESCRIPTION"     data-filter-control="input">角色描述</th>
      <th data-field="ROLE_DEFAULTURL" data-filter-control="input">角色預設頁</th>
    </tr>
  </thead>
</table>

因為欄位定義已經寫在表頭,JS 初始化時就不用再寫 columns:

$('#tb_roles').bootstrapTable({
    url: '/Role/GetRole',
    method: 'get',
    toolbar: '#toolbar',
    striped: true,
    cache: false,
    pagination: true,
    sortable: true,
    queryParams: function (param) { return param; },
    queryParamsType: "limit",
    detailView: false,
    sidePagination: "server",
    pageSize: 10,
    pageList: [10, 25, 50, 100],
    search: true,
    showColumns: true,
    showRefresh: true,
    minimumCountColumns: 2,
    clickToSelect: true
});

實際打開開發者工具追一次請求就會看到,篩選條件被序列化進 query string 一起送到後端:

後端接收到參數後反序列化即可使用:

這樣就不必自己擴充搜尋功能了,尤其在服務端分頁的情境下特別省事。

還沒講完的

Bootstrap Table 能玩的当然不会只有這些,像是列的合併、欄位的凍結等進階應用,就留待後續再補。以上三個功能都是實務案的常客,把範例跑通之後,照著換成自己的 API 就能用。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved