在项目中使用了dataTables 插件,学习整理一下。
dataTables 的官方中文网站 http://www.datatables.club
引入文件:
所有的都要引入 jq文件
1. dataTables 的样式
<link rel="stylesheet" href="jquery.dataTables.css">
<script src="jquery.dataTable.js">
2. bootstrap 风格的dataTables
<link rel="stylesheet" href="bootstrap.css">
<link rel="stylesheet" href="dataTables.bootstrap.css">
<script src="bootstrap.js">
<script src="jquery.dataTable.js">
<script src="dataTable.bootstrap.js">
HTML 代码
1 <table id="example" width="100%" class="table table-striped table-bordered">
2 <thead>
3 <tr>
4 <th>编码</th>
5 <th>职位</th>
6 <th>姓名</th>
7 <th>状态</th>
8 <th>项目</th>
9 <th>机构</th>
10 <th>操作</th>
11 </tr>
12 </thead>
13 </table>
JS 代码基本配置
1 var lang = {
2 "sProcessing": "处理中...",
3 "sLengthMenu": "每页 _MENU_ 项",
4 "sZeroRecords": "没有匹配结果",
5 "sInfo": "当前显示第 _START_ 至 _END_ 项,共 _TOTAL_ 项。",
6 "sInfoEmpty": "当前显示第 0 至 0 项,共 0 项",
7 "sInfoFiltered": "(由 _MAX_ 项结果过滤)",
8 "sInfoPostFix": "",
9 // "sSearch": "本地搜索:",
10 "sUrl": "",
11 "sEmptyTable": "暂无数据",
12 "sLoadingRecords": "载入中...",
13 "sInfoThousands": ",",
14 "oPaginate": {
15 "sFirst": "首页",
16 "sPrevious": "上页",
17 "sNext": "下页",
18 "sLast": "末页",
19 "sJump": "跳转"
20 },
21 "oAria": {
22 "sSortAscending": ": 以升序排列此列",
23 "sSortDescending": ": 以降序排列此列"
24 }
25 };
26
27 $('#example').DataTable({
28 "processing" : true, //DataTables载入数据时,是否显示进度条
29 "serverSide": true, // 开启服务端模式
30 "language": lang, //提示信息
31 "autoWidth": false, //自适应宽度,
32 "sScrollY" : 450, //DataTables的高
33 "sScrollX" : 820, //DataTables的宽
34 "columnDefs": [
35 {"targets": 0, "width": "10%"}, // 设置第一列的宽度
36 {"targets": 1, "width": "10%"},
37 {"targets": 2, "width": "10%"},
38 {"targets": 3, "width": "10%"},
39 {"targets": 4, "width": "20%"},
40 {"targets": 5, "width": "20%"},
41 {"targets": 6, "width": "20%"}
42 ],
43 "lengthMenu": [10, 20, 30], // 显示每页显示的条数
44 "stripeClasses": ["odd", "even"], // 为奇偶行添加样式
45 "searching": true, // 是否允许开启本地检索功能
46 "bFilter": false, // 去掉 搜索框
47 "paging": true, // 是否开启本地分页
48 "lengthChange": true, //是否允许产品改变表格每页显示的记录数
49 "info": true, // 控制是否显示表格左下角的信息
50 "bSort": false, // 禁止排序
51 "deferRender": true, // 延迟渲染
52 "pageLength": 10, // 每页显示的条数
53 //跟数组下标一样,第一列从0开始,这里表格初始化时,
54 "order": [2, 'asc'], //asc升序 desc降序 // 下标为2,第三列 生序排列
55 "aoColumnDefs": [{
56 "orderable": false,// 指定列不参与排序
57 "aTargets": [1,3,4,5,6] // 指定 下标为[1,3,4,5,6]的不排序
58 }],
59 "initComplete": function () { // 给每列添加下拉搜索
60 var api = this.api();
61 api.columns().indexes().flatten().each(function (i) {
62 if (i != 0 && i != 2 && i != 6) { // 第1,3,7不添加,其余的添加
63 var column = api.column(i);
64 var select = $('<select><option value=""></option></select>')
65 .appendTo($(column.header())) // 显示在table中最上面在thead里面
66 .on('change', function () {
67 var val = $.fn.dataTable.util.escapeRegex(
68 $(this).val()
69 );
70 column
71 .search(val ? val : '', true, false)
72 .draw();
73 });
74
75 column.data().unique().sort().each(function (d, j) {
76 var text = $(d).html(); // 获取 span 里面的 text
77 var val = $(d).attr("value"); // 获取span 里面的自定义属性 value
78 if(text != null && text.trim() != "" && val != null && text.trim() != ""){
79 select.append('<option value="' + val + '">' + text + '</option>')
80 }
81
82 });
83 }
84
85 });
86 },
87 "ajax": { // ajax 请求数据
88 "url": "请求路径",
89 "type": "get"
90 },
91 "columns":[
92 {data: name}(后台返回的字段名), // 有几列就解析几次
93 data: tell(后台返回的字段名),
94 ...
95 // 还可以写
96 //{
97 // "data": function (e) {
98 // return e.name;
99 // }
100 // },
101
102 ]
103
104
105 });
给每一列添加下拉搜索的方法 (2)官方
首先在html中添加
1 <tfoot>
2 <tr>
3 <th></th>
4 <th></th>
5 <th></th>
6 <th></th>
7 <th></th>
8 <th></th>
9 </tr>
10 </tfoot>
js代码
1 initComplete: function () {
2 var api = this.api();
3 api.columns().indexes().flatten().each( function ( i ) {
4 var column = api.column( i );
5 var select = $('<select><option value=""></option></select>')
6 .appendTo( $(column.footer()).empty() ) // 给tfoot里面添加select
7 .on( 'change', function () {
8 var val = $.fn.dataTable.util.escapeRegex(
9 $(this).val()
10 );
11 column
12 .search( val ? '^'+val+'$' : '', true, false )
13 .draw();
14 } );
15 column.data().unique().sort().each( function ( d, j ) {
16 select.append( '<option value="'+d+'">'+d+'</option>' )
17 } );
18 } );
19 }
给每列添加自定义属性
1 // 在 "columns" 下面添加
2 createdRow: function (row, data, index) {
3 // 给每列添加 自定义属性 name
4 $(row).attr('name',data.name);
5 }
给每列添加点击事件
$('#example tbody').on( 'click', 'tr', function () { }) ;
自定义的分页 ,只给后台传指定的参数
length // 页面显示的条数,每页显示多少条、
start // 开始的记录序号
draw // 当前页面
1 "ajax": function (data, callback, settings) {
2 //封装请求参数
3 var param = {};
4 param.length = data.length;//页面显示记录条数,在页面显示每页显示多少项的时候
5 param.start = data.start;//开始的记录序号
6 param.draw = data.draw;//当前页码
7
8 //ajax请求数据
9 $.ajax({
10 type: "get",
11 url: "请求路径",
12 cache: false, //禁用缓存
13 data: param,
14 dataType: "json",
15 success: function (result) {
16 //封装返回数据
17 var returnData = {};
18 returnData.draw = result.data.draw;//这里直接自行返回了draw计数器,应该由后台返回
19 returnData.recordsTotal = result.data.recordsTotal;//返回数据全部记录
20 returnData.recordsFiltered = result.data.recordsFiltered;//后台不实现过滤功能,每次查询均视作全部结果
21 returnData.data = result.data.data;//返回的数据列表
22 //调用DataTables提供的callback方法,代表数据已封装完成并传回DataTables进行渲染
23 //此时的数据需确保正确无误,异常判断应在执行此回调前自行处理完毕
24 callback(returnData);
25 }
26 });
27 },