jQuery外掛程式DataTables分頁開發技術分享

本文主要為大家分享了jQuery外掛程式DataTables分頁開發心得體會，具有一定的參考價值，有興趣的小夥伴們可以參考一下，希望能幫助大家。

寫Blog目的：不是為人氣，只是留份筆記；囉嗦不要緊，只怕有遺漏，以後想不起來。

開發環境：Python 3.6.0、Anaconda 4.3.1、Django、JetBrains PyCharm 2017.1.5

按我專案的開發流程簡單整理。

1、第一版，無分頁。

在此之前有用到DataTables（更多的是easyui中的Datagrid，另之前服務端是PHP），因此想著前端/客戶端差異不大，服務端反正都是按規範格式返回JSON字串（Django的程式碼後續再整理）。另外，剛開始也沒想著表格分頁，只是有三個欄位排序需求（排序已在服務端做好並回傳）。
DataTables基礎程式碼：

//表格的HTML代码略过
$('#dtList').DataTable({
        "bPaginate": false, //翻页功能
        "bInfo": false,//页脚信息
        "ordering": false, //不排序
        "searching": false,  //搜索框，不显示
        "bLengthChange": false, //改变每页显示数据数量，不显示
        "iDisplayLength": 10,  //每页默认显示数量（不显示了，这个设置也起不了作用）
        "serverSide":true, //服务端
        "retrieve":false, //意思是如果已经初始化了，则继续使用之前的Datatables实例。

        "ajax": {
          "type": "POST",
          "url": "/manage/getlist/",
          "data":{'csrfmiddlewaretoken': '{{ csrf_token }}'}, //Django的token值
          "dataSrc": function (result) { //使用dataSrc属性来设置获取到的数据格式，其值是服务端拼好的key-value（数据字段名称-字段值）【服务端走了弯路，后续有时间再写文章说明】
            var json = JSON.parse(result).data;
            return json;
          }
        },
        "columns": [ //表格要显示的列定义(字段名称做了处理)
          { "data": "field0",
            "visible":false,
            "render": function ( data, type, full, meta ) {
              //return &#39;<input type="checkbox"/>&#39;;
              return data;
            }
          },
          { "data": "field1" },
          { "data": "field2" , //此列名要与服务端返回的JSON串中的值一致
            "render": function ( data, type, full, meta ) {
              return &#39;<p style="text-align:left">&#39;+data+&#39;</p>&#39;;
            }
          },
          //其余字段定义省略
          ]
        });

2、加上分頁功能

第一個程式寫好幾天後就準備加上分頁功能。
DataTables的JSON字串格式要求：

{
  "draw": n, 
  "recordsTotal": n, //总记录数
  "recordsFiltered": n, //条件过滤后的记录数，与总记录数可能会不同
  "data": [{}] //获取到的记录集合
}

依照先前處理easyui中Datagrid元件的經驗，得到總記錄數，篩選後的記錄數等值，拼好JSON串回傳就行，客戶端可以直接實現分頁。

可是，問題來了：draw的值怎麼控制？

查了資料，也追蹤了下瀏覽器的header，知道draw是DataTables本身的一個屬性值，每次取得資料時都會向服務端傳，不需要改這個值，直接在JSON串中回傳就好。試了下，不知道問題出在哪，好像分頁也不行，而且總覺得這種控制方法有點累。

換個想法再查資料，就是服務端分頁（按需請求對應資料），還真有：django-datatables-view（datatables for django，https://pypi.python.org/ pypi/django-datatables-view），按其安裝步驟來就好，這樣子就不用考慮JSON串幾個值怎麼拼的問題了，這個元件會做好。

改進後的前端程式碼：

$('#dtList').DataTable({
    "bPaginate": true, //翻页功能
    "bInfo": true,//页脚信息
    "ordering":true, //开启排序
    "searching": false, //搜索框，不显示
    "bLengthChange": true, //改变每页显示数据数量，不显示
    "aLengthMenu": [[5, 10, 25, 50, -1], [5, 10, 25, 50, "All"]], //每页显示记录菜单选项
    "iDisplayLength": 10, //每页默认显示数量
    "serverSide":true, //开启服务端请求模式
    'pagingType': 'full_numbers',
    "retrieve":true,

    "ajax": { //这边就不需要dataSrc属性来处理值了
     "type": "GET",
     "url": "{% url 'scheme_list_json' %}",
     "data":{
      'sSearch':'',
      'csrfmiddlewaretoken': '{{ csrf_token }}'},
     },
    "columns": [ //表格要显示的列定义
     { "data": 0,
      "visible":false,
      "render": function ( data, type, full, meta ) {
       //return &#39;<input type="checkbox"/>&#39;;
       return data;
      }
     },
     { "data": 1
     "bSortable":false
     },
     { "data": 2,
      "bSortable":false, //此字段不排序
      "render": function ( data, type, full, meta ) {
       return &#39;<p style="text-align:left">&#39;+data+&#39;</p>&#39;;
      }
     },
     //其余字段定义省略
     ......
     ],
    "aaSorting": [ //指定排序的列（索引从0开始）及规则
     [ 8, "asc" ],
     [ 9, "asc" ],
     [ 10, "desc" ]
     ],
    "drawCallback": function( settings ) { //绘制表格时的回调函数
     $("th").removeClass("sorting_asc"); //删除排序图标，升序样式
     $("th").removeClass("sorting_desc");//降序样式 
   });

排序成功，但問題來了：開啟排序功能後，表頭行會有排序的圖標，但我們不需要它（只是排序，不需要點擊），所以加上上面程式碼中的drawCallback回調函數，去掉其樣式就好。
PS：
有個坑-服務端的回傳字段和排序字段的列數一定要一一對應，前端DataTables顯示字段columns定義也要按這個順序來，否則前端排序會亂，如：

 # 需要显示的字段
 columns = ['jyjhbid', 'tzbd', 'clsc', 'clzt', 'jlscrq', 'jlxgrq', 'clcz'] 

 # 排序
 order_columns = ['jyjhbid', 'tzbd', 'clsc', 'clzt', 'jlscrq', 'jlxgrq', 'clcz']

剛接觸django-datatables-view，以為這兩個集合值可以不同，所以。 。 。 。多走了些路。

相關建議：

jQuery Datatables表頭不對齊的解決方法

Datatables表頭不對齊怎麼辦

jquery外掛程式datatables屬性介紹及建立分頁、排序​​實例詳解

以上是jQuery外掛程式DataTables分頁開發技術分享的詳細內容。更多資訊請關注PHP中文網其他相關文章！