前端常用功能记录(三)—datatables表格初始化

       其实上篇说的也算是jQuery Datatables的初始化，但主要是对某些字段意义的理解。下面记录的是datatables常用的功能的初始化。

数据源

我经常使用的有两种，一种是JavaScript 中的数组，通过在初始化对象中传递一个名为 aaData 的数组，同样可以提供表格数据，前缀 aa 说明这是一个数组的数组，外层的数组表示表格的行，每一行同样是一个数组。

（字段的命名可以使用类型加字段名称也可以直接使用如aaData，也可以是data，aoColumns，也可以是columns)

如：

$(document).ready(function() {
    $('#demo').html( '<table class="table b-t b-light"  id="datatables"> </table>' );
    $('#example').dataTable( {
        data: [
            [ "Trident", "Internet Explorer 4.0", "Win 95+", 4, "X" ],
            [ "Trident", "Internet Explorer 5.0", "Win 95+", 5, "C" ],
            [ "Trident", "Internet Explorer 6.0", "Win 98+", 6, "A" ],
            [ "Trident", "Internet Explorer 7.0", "Win XP SP2+", 7, "A" ],
            [ "Gecko", "Firefox 1.5", "Win 98+ / OSX.2+", 1.8, "A" ],
            [ "Gecko", "Firefox 2", "Win 98+ / OSX.2+", 1.8, "A" ],
            [ "Gecko", "Firefox 3", "Win 2k+ / OSX.3+", 1.9, "A" ],
            [ "Webkit", "Safari 1.2", "OSX.3", 125.5, "A" ],
            [ "Webkit", "Safari 3.0", "OSX.4+", 522.1, "A" ]
        ],
        columns: [
            { "sTitle": "Engine" },
            { "sTitle": "Browser" },
            { "sTitle": "Platform" },
            { "sTitle": "Version", "sClass": "center" },
            {
                "sTitle": "Grade",
                "sClass": "center",
                "fnRender": function(obj) {
                    var sReturn = obj.aData[ obj.iDataColumn ];
                    if ( sReturn == "A" ) {
                        sReturn = "<b>A</b>";
                    }
                    return sReturn;
                }
            }
        ],
        paging: false,
        order:[
                [1, "asc"]
        ],
        dom: 'lrtp',
        columnDefs: [
            {width: '30%', targets: 0},
        ],
    } );    
} );

aoColumns 参数用来定义表格的列，这是一个数组，其中的每一个对象用来定义一列。

对于每一个列对象：

sTitle 定义列的标题

sClass 定义列的样式

fnRender 函数用来渲染列，这个函数将会传递一个参数对象，这个参数对象的 iDataColumn 属性表示当前的列索引，aData 表示当前的行数组。函数返回的结果将被填充到单元格中。

如果data是从后台传过来的二维数组，则data可以赋值如下：

data: <%- JSON.stringify(aaData) %>, // aaData是后台传过来的

 

第二种方式是从HTML表（而不是一个Ajax或JavaScript数据源）读取数据表的内容，默认情况下它会读取表中的信息转换为内部数据表的数组。每个阵列元素表示一列。

传入的数据格式如下（如从数据库中读取返回的数据格式）：

[{
    "name":    "...",
    "position":   "...",
    "office":    "...",
    "age":      "...",
    "start_date": "...",
    "salary":    "..."},
{
    "name":    "...",
    "position":   "...",
    "office":    "...",
    "age":      "...",
    "start_date": "...",
    "salary":    "..."},
]

表格初始化的格式如下：

$(document).ready(function() {
    $('#example').DataTable({
        "columns": [
            { "data": "name", },
            { "data": "position" ,},
            { "data": "office", },
            { "data": "age", },
            { "data": "start_date", },
            { "data": "salary" ,"visible": false,}
        ],
        "order": [
                [3, "desc"]
        ],
        "sPaginationType": "full_numbers",
    });
} );

 

使用columnDefs隐藏列

$(document).ready(function() {
    $('#example').dataTable( {
        "columnDefs": [
            {
                "targets": [ 2 ],
                "visible": false,
                "searchable": false  //不可通过第三列字段内容作为关键字来搜索
            },
            {
                "targets": [ 3 ],
                "visible": false
            }
        ]
    } );
} );

 

垂直和水平滚动

//垂直滚动
$(document).ready(function() {
    $('#example').dataTable( {
        "scrollY":        "200px",
        "scrollCollapse": true,
        "paging":         false
    } );
} );

//水平滚动
$(document).ready(function() {
    $('#example').dataTable( {
        "scrollX":   true,
    } );
} );

 

数字表达

$(document).ready(function() {  //$433.060,00
    $('#example').dataTable( {
        "language": {
            "decimal": ",",
            "thousands": "."
        }
    } );
} );

 

语言选择

$(document).ready(function() {
    $('#example').dataTable( {
        "language": {
            "sProcessing": "<img src='/images/datatable_loading.gif'>  努力加载数据中.",
            "sLengthMenu": "每页显示 _MENU_ 条记录",
            "sZeroRecords": "抱歉， 没有找到",
            "sInfo": "从 _START_ 到 _END_ /共 _TOTAL_ 条数据",
            "sInfoEmpty": "没有数据",
            "sInfoFiltered": "(从 _MAX_ 条数据中检索)",
            "sZeroRecords": "没有检索到数据",
            "sSearch": "模糊查询:  ",
            "oPaginate": {
                "sFirst": "首页",
                "sPrevious": "前一页",
                "sNext": "后一页",
                "sLast": "尾页"
            }
        },
    } );
} );

 

分页长度选择

$(document).ready(function() {
    $('#example').dataTable( {
        "lengthMenu": [[10, 25, 50, -1], [10, 25, 50, "All"]]
    } );
} );

 

多个表控制元件

$(document).ready(function() {
    $('#example').dataTable( {
        "dom": '<"top"iflp<"clear">>rt<"bottom"iflp<"clear">>'
    } );
} );
//在表格首部和尾部均有iflp的信息，并且上下是同步的

 

自定义toolbar

$(document).ready(function() {
    $('#example').dataTable( {
        "dom": '<"toolbar">frtip'
    } );

    $("div.toolbar").html("<button class='btn btn-primary add_server'><span>添加物理机</span></button>");
        $(".add_server").click(function(){
          location.href ="/server/import"
        })
} );

 

列渲染Column rendering

操纵一单元格的内容，这种技术可用于添加链接，基于内容的规则，需要指定颜色或任何其他形式的文本操作非常有用。

$(document).ready(function() {
    $('#example').dataTable( {
        "columnDefs": [
            {
                "render": function ( data, type, row ) {
                    return data +' ('+ row[3]+')';
                },
                "targets": 0
            },
            { "visible": false,  "targets": [ 3 ] }
        ]
    } );
} );

 

设置表的默认属性--Setting defaults

$.extend( $.fn.dataTable.defaults, {
    "searching": false,
    "ordering": false
} );

 

DOM / jQuery events

$(document).ready(function() {
    $('#example').dataTable();
     
    $('#example tbody').on('click', 'tr', function () {
        var name = $('td', this).eq(0).text();
        alert( 'You clicked on '+name+'\'s row' );
    } );
} );

 

行回调

$(document).ready(function() {
    $('#example').dataTable( {
        "createdRow": function ( row, data, index ) {
            if ( data[5].replace(/[\$,]/g, '') * 1 > 150000 ) {
                $('td', row).eq(5).addClass('highlight');
            }
        },
        
        "rowCallback": function(row, data) {
            // ip列添加链接
            if(data.ip) {
              $('td:eq(3)', row).html('<a target="_blank" href=http://' + data.ip + '>' + data.ip + '</a>');
            }
        },
        
    } );
} );