jQueryプラグインDataTablesページング開発技術共有

この記事は主に jQuery プラグイン DataTables ページングの開発経験を共有します。興味のある友人が参考になれば幸いです。

ブログを書く目的: 人気を得るためではなく、ただメモを残すためです。長くても構いません。何かを見逃したり、後で思い出せなくなったりするのではないかと心配です。

開発環境: Python 3.6.0、Anaconda 4.3.1、Django、JetBrains PyCharm 2017.1.5

私のプロジェクトの開発プロセスに従って簡単に整理しました。

1. 最初のバージョン、ページングなし。

以前に DataTables を使用したことがあります (easyui の Datagrid が多く、以前のサーバーは PHP でした)。そのため、フロントエンドとクライアントの間に大きな違いはなく、サーバーはとにかく標準形式で JSON 文字列を返すと思いました。 (Django のコードは後で整理します)。さらに、最初はテーブルのページネーションについては考慮していませんでした。フィールドの並べ替え要件は 3 つだけでした (並べ替えはサーバー側で行われて返されました)。
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はデータが取得されるたびにサーバーに渡されることがわかりました。値は JSON 文字列で直接返されます。試してみましたが、ページングがうまくいかないようで、何が問題なのかわかりません。この制御方法は少し面倒だといつも感じます。

考え方を変えて、情報を再度確認してみましょう。つまり、サーバー側のページング (オンデマンドで対応するデータを要求する) です。実際には、 django-datatables-view (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コールバック関数を追加し、そのスタイルを削除するだけです。
追記:
落とし穴があります。サーバー上の戻り値フィールドと並べ替えフィールドの列数は 1 対 1 に対応する必要があり、フロントエンド DataTables 表示フィールドの列定義もこの順序でなければなりません。そうでない場合は、フロントエンドのソートは次のようにめちゃくちゃになります:

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

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

私は django-datatables-view を初めて使用するので、2 つのコレクション値が異なる可能性があると考えました。 。 。 。さらに何マイルも歩きました。

関連する推奨事項:

jQuery Datatables ヘッダーが整列していない場合の対処方法

Datatables ヘッダーが整列していない

jQuery プラグインの datatables 属性の紹介と、ページングとソートの作成例の詳細な説明

以上がjQueryプラグインDataTablesページング開発技術共有の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。