DIV CSS 佈局教程網

Bootstrap Table 終結篇:客製列樣式、行內編輯、合併儲存格與資料匯出
編輯:關於JavaScript     

Bootstrap Table 輕量、功能齊全,單選多選、排序分頁、欄位開關、固定表頭、響應式、AJAX 載入 JSON、卡片檢視一应俱全。前面兩篇談了基礎與進階擴充,這一篇收尾,把報表場景最常出現的四個需求一次講完。

一、成果預覽

1. 依狀態上色

訂單頁面很常見的需求:不同狀態的訂單用不同底色區隔。

2. 行內編輯

點一下儲存格就能就地編輯,不必跳出視窗。

3. 合併列與欄

做報表時幾乎一定會遇到,尤其是跨欄的季度標題。

4. 資料匯出

支援三種範圍:basic(目前頁)、all(全部)、selected(勾選列),格式則有 Excel、XML、JSON 等。

匯出目前頁:

匯出全部:

匯出勾選列:

其他格式與 Excel 的設定方式幾乎相同,就不再逐一示範。

二、列樣式:用 rowStyle

自己用 jQuery 幫 tr 設背景色當然也行,但既然元件內建了機制,用官方 API 更省事,也比較不會跟元件的其他行為打架。

$('#tb_order').bootstrapTable({
    url: '/TableStyle/GetOrder',
    method: 'get',
    striped: true,
    cache: false,
    pagination: true,
    sortable: false,
    sortOrder: "asc",
    queryParams: oTableInit.queryParams,
    sidePagination: "server",
    pageNumber: 1,
    pageSize: 10,
    pageList: [10, 25, 50, 100],
    search: true,
    strictSearch: true,
    showColumns: true,
    showRefresh: true,
    minimumCountColumns: 2,
    clickToSelect: true,
    height: 500,
    uniqueId: "ID",
    showToggle: true,
    cardView: false,
    detailView: false,
    rowStyle: function (row, index) {
        // 五個可選值對應五種顏色
        // ['active', 'success', 'info', 'warning', 'danger']
        var strclass = "";
        if (row.ORDER_STATUS == "待排產") {
            strclass = 'success';
        } else if (row.ORDER_STATUS == "已刪除") {
            strclass = 'danger';
        } else {
            return {};
        }
        return { classes: strclass };
    },
    columns: [
        { checkbox: true },
        { field: 'ORDER_NO',     title: '訂單編號' },
        { field: 'ORDER_TYPE',   title: '訂單類型' },
        { field: 'ORDER_STATUS', title: '訂單狀態' },
        { field: 'REMARK',       title: '備註' }
    ]
});

核心就是 rowStyle 這段。回傳值必須是形如 { classes: strclass } 的物件——這點第一次用時很容易卡住,因為文件沒特別強調。五種顏色實際渲染出來的效果,把程式跑一次就一目了然。

三、行內編輯:借 x-editable 之力

引入擴充所需的 CSS 與 JS:

<link rel="stylesheet" href="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/css/bootstrap-editable.css">
<script src="//rawgit.com/vitalets/x-editable/master/dist/bootstrap3-editable/js/bootstrap-editable.js"</script>
<script src="~/Content/bootstrap-table/extensions/editable/bootstrap-table-editable.js"</script>

在表頭標記哪些欄位可編輯:

<table id="tb_departments">
  <thead>
    <tr>
      <th data-field="Name"       data-editable="true">部門名稱</th>
      <th data-field="ParentName">上級部門</th>
      <th data-field="Level"      data-editable="true">部門級別</th>
      <th data-field="Desc"       data-editable="true">描述</th>
    </tr>
  </thead>
</table>

若改用 JS 定義欄位,寫成 { field: "name", title: "名稱", editable: true } 即可。

接著註冊儲存事件:

$('#tb_departments').bootstrapTable({
    url: '/Editable/GetDepartment',
    method: 'get',
    toolbar: '#toolbar',
    striped: true,
    cache: false,
    pagination: true,
    sortable: false,
    sortOrder: "asc",
    queryParams: oTableInit.queryParams,
    sidePagination: "server",
    pageNumber: 1,
    pageSize: 10,
    onEditableSave: function (field, row, oldValue, $el) {
        $.ajax({
            type: "post",
            url: "/Editable/Edit",
            data: { strJson: JSON.stringify(row) },
            success: function (data, status) {
                if (status == "success") { alert("編輯成功"); }
            },
            error: function () { alert("Error"); }
        });
    }
});

四個參數分別是:欄位名稱、該列資料物件、修改前的值、目前儲存格的 jQuery 物件。保存邏輯要自己在回呼裡實作。

四、合併儲存格:colspan 與 rowspan

這個功能不需要任何額外 JS,直接用原生 table 屬性就能做到,只在表頭寫就好。

<table id="tb_report">
  <thead>
    <tr>
      <th colspan="4" data-valign="middle" data-align="center">第一季</th>
      <th colspan="4" data-valign="middle" data-align="center">第二季</th>
      <th colspan="4" data-valign="middle" data-align="center">第三季</th>
      <th colspan="4" data-valign="middle" data-align="center">第四季</th>
      <th data-field="TotalCount" rowspan="2" data-valign="middle" data-align="center">年度匯總</th>
    </tr>
    <tr>
      <th data-field="JanCount" data-align="center">一月</th>
      <th data-field="FebCount" data-align="center">二月</th>
      <th data-field="MarCount" data-align="center">三月</th>
      <th data-field="FirstQuarter" data-align="center">第一季</th>
      <th data-field="AprCount" data-align="center">四月</th>
      <th data-field="MayCount" data-align="center">五月</th>
      <th data-field="JunCount" data-align="center">六月</th>
      <th data-field="SecondQuarter" data-align="center">第二季</th>
      <th data-field="JulCount" data-align="center">七月</th>
      <th data-field="AguCount" data-align="center">八月</th>
      <th data-field="SepCount" data-align="center">九月</th>
      <th data-field="ThirdQuarter" data-align="center">第三季</th>
      <th data-field="OctCount" data-align="center">十月</th>
      <th data-field="NovCount" data-align="center">十一月</th>
      <th data-field="DecCount" data-align="center">十二月</th>
      <th data-field="ForthQuarter" data-align="center">第四季</th>
    </tr>
  </thead>
</table>

JS 初始化不需要任何特殊設定:

$('#tb_report').bootstrapTable({
    url: '/GroupColumns/GetReport',
    method: 'get',
    toolbar: '#toolbar',
    striped: true,
    cache: false,
    pagination: true,
    sortOrder: "asc",
    queryParams: oTableInit.queryParams,
    sidePagination: "server",
    pageNumber: 1,
    pageSize: 10,
    pageList: [10, 25, 50, 100]
});

其實連 JS 都可以省——查一下 API 會發現每個初始化參數都有對應的 table 屬性,只要沒有特殊事件要處理,純 HTML 宣告就足夠。

五、資料匯出

<script src="~/Content/bootstrap-table/extensions/export/bootstrap-table-export.js"</script>
<script src="//rawgit.com/hhurz/tableExport.jquery.plugin/master/tableExport.js"</script>
$('#tb_departments').bootstrapTable({
    url: '/Export/GetDepartment',
    method: 'get',
    toolbar: '#toolbar',
    striped: true,
    cache: false,
    pagination: true,
    sortable: false,
    sortOrder: "asc",
    queryParams: oTableInit.queryParams,
    sidePagination: "client",
    pageNumber: 1,
    pageSize: 10,
    pageList: [10, 25, 50, 100],
    clickToSelect: true,
    showExport: true,        // 是否顯示匯出按鈕
    exportDataType: "basic", // 'basic' | 'all' | 'selected'
    columns: [
        { checkbox: true },
        { field: 'Name',       title: '部門名稱' },
        { field: 'ParentName', title: '上級部門' },
        { field: 'Level',      title: '部門級別' },
        { field: 'Desc',       title: '描述' }
    ]
});

要動的只有 showExport 與 exportDataType 這兩行。

兩個待解的問題

1. 行內編輯的請求粒度。目前是每個儲存格各自 POST 一次,一次編輯多格就會產生多次資料庫寫入。理想上應該改成整列一起送出,但元件沒有現成支援,需要自己攔下編輯事件累積成批次。

2. 匯出的瀏覽器相容性。這個擴充在 IE 上無法運作,用官方範例頁實測同樣匯不出來。若專案還需要支援 IE,匯出得另外找方案或直接在後端產檔。

以上就是 Bootstrap Table 系列的三篇內容。從基礎綁定一路到報表級的客製化,這個元件的表現確實稱得上「表格神器」。

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