JS組件系列之Bootstrap table表格組件神器【終結篇】,bootstraptable
bootstrap table系列:
JS表格組件神器bootstrap table詳解(基礎版)
JS組件系列之Bootstrap table表格組件神器【終結篇】
JS組件系列之Bootstrap table表格組件神器【二、父子表和行列調序】
Bootstrap Table是輕量級的和功能豐富的以表格的形式顯示的資料,支援單選,複選框,排序,分頁,顯示/隱藏列,固定標題滾動表,響應式設計,Ajax載入JSON資料,點擊排序的列,卡片視圖等。那麼本文給大家介紹JS組件系列之Bootstrap table表格組件神器【終結篇】,一起學習吧!
一、效果展示
1、表格行樣式
比如我們有一個顯示訂單頁面的需求,不同狀態的訂單顯示不同的顏色,
2、表格行內編輯
第一篇的時候有園友就問過博主是否可以支援行內編輯的效果,答案是肯定的。我們先來看看效果:
編輯前
點擊某個儲存格資料
編輯後完成後
3、表格行列合并
關於行列合并的需求博主覺得是非常常見的,尤其是做頁面報表的時候需要用到。先來看看效果:
當前頁顯示不全,點擊進入看看。怎麼樣?效果還不錯吧。
4、表格式資料匯出
關於表格式資料匯出,bootstrap table支援三種模式的匯出:basic、all、selected。也就是當前頁資料匯出、所有資料匯出、選中資料匯出。並且支援匯出多種類型的檔案,比如常見的excel、xml、json等格式。
匯出當前頁到excel
匯出表格所有資料
匯出選中行資料
至於其他類型的檔案的匯出,和excel基本相同,就不做效果展示了。
二、表格行樣式程式碼範例
關於表格行的樣式設定,其他是它一個最基礎的功能,為什麼要把它放在第三篇?是因為博主覺得這功能可能到處都用得著。當然,效果並不難,自己用jQuery設定tr的背景色也可以實現,但是博主覺得,既然bootstrap table提供了機制設定行的背景色,我們何不用它內建的api呢。我們看看如何?。
初始化表格的時候
//初始化Table$('#tb_order').bootstrapTable({url: '/TableStyle/GetOrder', //請求背景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, //是否顯示父子表rowStyle: function (row, index) {//這裡有5個取值代表5中顏色['active', 'success', 'info', 'warning', 'danger'];var strclass = "";if (row.ORDER_STATUS == "待排產") {strclass = 'success';//還有一個active}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: function (row, index) {//這裡有5個取值代表5中顏色['active', 'success', 'info', 'warning', 'danger'];var strclass = "";if (row.ORDER_STATUS == "待排產") {strclass = 'success';//還有一個active}else if (row.ORDER_STATUS == "已刪除") {strclass = 'danger';}else {return {};}return { classes: strclass }},
bootstrap table支援5中表格的行背景色,分別是'active', 'success', 'info', 'warning', 'danger'這五種,至於每種對應的背景顏色,將代碼運行起來就可看到。關於這個方法的傳回值,博主第一次用的時候也研究了好久,按照bootstrap table的規則,必須返回一個json格式的對象型如: { classes: strclass } 。
三、表格行內編輯程式碼範例
關於表格行內編輯,需要使用bootstrap table擴充的幾個js檔案。
1、引入額外的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>
2、在cshtml頁面定義表格時,添加兩個屬性
<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}
3、在js裡面初始化表格的時候註冊編輯儲存的事件
$('#tb_departments').bootstrapTable({url: '/Editable/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, //每頁的記錄行數(*)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");},complete: function () {}});}});
重點還是看看這個事件的處理方法
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");},complete: function () {}});}
對應的方法裡面需要自己處理儲存的邏輯。四個參數field, row, oldValue, $el分別對應著當前列的名稱、當前行資料對象、更新前的值、編輯的目前的儲存格的jQuery對象。
四、表格行列合并程式碼範例
表格的行列合并功能不用引用其他的js檔案,只需要在cshtml頁面使用table的colspan和rowspan即可實現。
1、cshtml頁面
<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>
2、js初始化並無特殊
$('#tb_report').bootstrapTable({url: '/GroupColumns/GetReport', //請求背景URL(*)method: 'get', //請求方式(*)toolbar: '#toolbar', //工具按鈕用哪個容器striped: true, //是否顯示行間隔色cache: false, //是否使用緩衝,預設為true,所以一般情況下需要設定一下這個屬性(*)pagination: true, //是否顯示分頁(*)sortOrder: "asc", //排序方式queryParams: oTableInit.queryParams,//傳遞參數(*)sidePagination: "server", //分頁方式:client用戶端分頁,server服務端分頁(*)pageNumber: 1, //初始化載入第一頁,預設第一頁pageSize: 10, //每頁的記錄行數(*)pageList: [10, 25, 50, 100], //可供選擇的每頁的行數(*)});
怎麼樣,有沒有很簡單。當然,有人說了,你都可以不用js初始化,直接在cshtml裡面用table的屬性去設定url、分頁等資訊。確實,如果我們看過它的api,會發現它初始化的每一個屬性都對應一個table的屬性。型如
如果你的表格沒有一些特殊的事件需要處理,這樣是完全沒有問題的。
五、表格式資料匯出程式碼範例
表格式資料的匯出功能也需要一些擴充的js支援。
1、引入額外的js檔案
<script src="~/Content/bootstrap-table/extensions/export/bootstrap-table-export.js"></script><script src="//rawgit.com/hhurz/tableExport.jquery.plugin/master/tableExport.js"></script>
2、js初始化的時候
$('#tb_departments').bootstrapTable({url: '/Export/GetDepartment', //請求背景URL(*)method: 'get', //請求方式(*)toolbar: '#toolbar', //工具按鈕用哪個容器striped: true, //是否顯示行間隔色cache: false, //是否使用緩衝,預設為true,所以一般情況下需要設定一下這個屬性(*)pagination: true, //是否顯示分頁(*)sortable: false, //是否啟用排序sortOrder: "asc", //排序方式queryParams: oTableInit.queryParams,//傳遞參數(*)sidePagination: "client", //分頁方式:client用戶端分頁,server服務端分頁(*)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: true, //是否顯示匯出exportDataType: "basic", //basic', 'all', 'selected'.showExport表示是否顯示匯出的按鈕,exportDataType表示匯出的模式是當前頁、所有資料還是選中資料。
六、總結
以上就是功能的效果以及實現的簡單代碼。博主發現有幾個問題有待解決。
1、行內編輯的功能是每一個儲存格提交到後台,這樣會造成資料庫的頻繁操作,感覺不太合適。不知道有沒有更好的方式,每行提交到後台。
2、匯出的功能雖然很好用,但是遺憾的是不支援IE瀏覽器,博主試過官網上面的example,好像IE也匯出不了。待驗證。
以上所述是小編給大家介紹的JS組件系列之Bootstrap table表格組件神器【終結篇】的相關內容,希望對大家有所協助!