jQuery表格插件datatables用法匯總

字號:


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