前端常用功能记录(三)—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>');            }        },            } );} );