DataTables是一個jQuery的表格插件,本文為大家分享了表格插件datatables用法,介紹了基礎的部分知識,具體內容如下
一、初始化
在頁面中
<!DOCTYPE html> <html> <head> <link rel="stylesheet" type="text/css" href="//cdn.datatables.net/1.10.11/css/jquery.dataTables.css"> <script type="text/javascript" charset="utf8" src="//cdn.datatables.net/1.10.11/js/jquery.dataTables.js"></script> </head> <body> <table id="table_id" class="display"> <thead> <tr> <th>Column 1</th> <th>Column 2</th> </tr> </thead> <tbody> <tr> <td>Row 1 Data 1</td> <td>Row 1 Data 2</td> </tr> <tr> <td>Row 2 Data 1</td> <td>Row 2 Data 2</td> </tr> </tbody> </table> </body> </html>
js中初始化
$(document).ready( function () { $('#table_id').DataTable(); } );
二、常用配置
在初始化的時候可以通過一些常用的配置項對表格進行配置,這是我在項目中實際用到的
$("#vivo_table_list").dataTable({ pageLength: 10, //更改初始頁面長度 (每頁的行數) processing: true, //顯示正在處理字符串 serverSide: false, // 服務器模式,這一點非常奇怪* ordering: true, // 是否啟用Datatables排序 searching: false, // 開啟搜索 autoWidth: false, zeroRecords: "沒有查詢數據", destroy: true, // 從當前上下文銷毀掉Datatables對象 (妹搞懂) pagingType: "input", // 分頁按鈕種類顯示選項 language: { url: "cn.txt" // 本地化 }, dom: "tr<'row-fluid'<'span6'i><'span6'p>>", // 按什麼順序定義表的控制元素在頁面上出現(妹搞懂) ajax: { url: "/url", type: "post", // ajax請求的類型 ** data: function () { return that.getQueryParams(); // ajax的參數 } }, columns: [ {title: "id", data: "id", orderable: true}, {title: "uid", data: "uid", orderable: false}, {title: "昵稱", data: "nick", orderable: false}, {title: "姓名", data: "name", orderable: false}, {title: "電話", data: "tel", orderable: false}, {title: "申請時間", data: "stimeshow", orderable: true}, {title: "狀態", data: "statshow", orderable: false}, { title: "操作", orderable: false, render: function (data,type,full) { return '<button id="msgsndButton" class="msgsnd glyphicon glyphicon-comment"></button>' + ' <button id="forbidButton" class="forbid glyphicon glyphicon-thumbs-down"></button>'+ '<input type="hidden" value="'+full.id+'"/>'; } } ] });
後台傳回的數據一定要是一個map,key是 "data",value 是數據(如果數據是List要 toArray()),其中 data 也是 DataTables 的參數之一,表示表格要顯示的數據,所以你可以在這個map中放上其他的表格參數,只要把key設置為參數名就可以了。
*:配置中serverSide開啟服務器模式,在工作使用中表格的數據是通過ajax從後台獲取,就理所當然地打開了這個模式,但是表格對某一列排序的功能就失效了,而隨後我關閉了這一模式,發現就可以對表格中的列進行排序,表格的數據還是從服務器獲取……所以這個模式還有待研究
**: 在項目中後台controller接收的參數是數組,ajax的請求包含復雜參數的時候,請求的類型一定要是post;
三、進階功能
1、隱藏列
可以通過 "columns.visible" 屬性規定列是否顯示,但是這樣就不能獲取此列的值,如果要隱藏id列,又要根據id觸發事件就辦不到了 = =,後來查API後想了一個笨辦法,可以借助 columns.render 屬性,用法如下:
{ title: "操作", orderable: false, render: function (data,type,full) { return '<input type="hidden" value="'+full.id+'"/>'; } }
注意 render 後的函數有三個參數,data/type/full,其中full參數是行的所有數據(官網在此注明:只是行中的數據,而不是data屬性的值,所以就算data中有你想要的值,但你沒有給他一列的話也是獲取不到的),可以在render中直接使用你想隱藏的值,如果表格外部要引用這個值,可以在render中組裝一個隱藏的<input>,外部就可以獲取到了,不過這種方法真的非常蠢,如果你有好的方法,請一定要告訴我。
2、輸入頁碼跳轉頁面
我們可以通過 pagingType 屬性來設置表格分頁按鈕樣式,但是DataTables的幾個默認樣式都沒有項目中需要的輸入頁碼進行跳轉的樣式。但是在官網的 plug-in 頁中介紹了幾種分頁按鈕的插件,其中的 input 分頁插件就可以滿足我們的需求,只要引入插件的js,再將 pagingType 的值改為 "input" 就可以了。js文件的 CDN 是:
//cdn.datatables.net/plug-ins/1.10.11/pagination/input.js
以上就是本文的全部內容,希望對大家的學習有所幫助。
DataTables 官網