DataTables开发心得--分页

写Blog目的：不是为人气，只是留份笔记；啰嗦不要紧，只怕有遗漏，以后想不起来。

官网：https://datatables.net/
中文官网：http://datatables.club/

开发环境：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 '<input type="checkbox"/>';
                            return data;
                        }
                    },
                    { "data": "field1" },
                    { "data": "field2" , //此列名要与服务端返回的JSON串中的值一致
                        "render": function ( data, type, full, meta ) {
                            return '<div style="text-align:left">'+data+'</div>';
                        }
                    },
                    //其余字段定义省略
                    ]
               });

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 '<input type="checkbox"/>';
                            return data;
                        }
                    },
                    { "data": 1
                    "bSortable":false
                    },
                    { "data": 2,
                        "bSortable":false, //此字段不排序
                        "render": function ( data, type, full, meta ) {
                            return '<div style="text-align:left">'+data+'</div>';
                        }
                    },
                    //其余字段定义省略
                    ......
                    ],
                "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，以为这两个集合值可以不同，所以。。。。多走了些路。