AutoFill example Step callback

By default, AutoFill will increment cells that contain numbers by a single digit for each cell that is iterated over (try the Age column below for example). This behaviour can be disabled completely using the increment column option, but it can also be modified to suit your requirements through use of the step column callback function.

The step callback is executed for each cell in the auto-fill set and gives complete control over how data is incremented. The example below shows the step function being used on the Salary column to increment by 100, rather than 1 for each cell.

For a complete description of the step callback, please refer to the AutoFill documentation.

NamePositionOfficeAgeStart dateSalary
NamePositionOfficeAgeStart dateSalary
Airi Satou Accountant Tokyo 33 2008/11/28 $162,700
Angelica Ramos Chief Executive Officer (CEO) London 47 2009/10/09 $1,200,000
Ashton Cox Junior Technical Author San Francisco 66 2009/01/12 $86,000
Bradley Greer Software Engineer London 41 2012/10/13 $132,000
Brenden Wagner Software Engineer San Francisco 28 2011/06/07 $206,850
Brielle Williamson Integration Specialist New York 61 2012/12/02 $372,000
Bruno Nash Software Engineer London 38 2011/05/03 $163,500
Caesar Vance Pre-Sales Support New York 21 2011/12/12 $106,450
Cara Stevens Sales Assistant New York 46 2011/12/06 $145,600
Cedric Kelly Senior Javascript Developer Edinburgh 22 2012/03/29 $433,060
Showing 1 to 10 of 57 entries

The Javascript shown below is used to initialise the table shown in this example:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
$(document).ready(function() {
    var table = $('#example').dataTable();
 
    new $.fn.dataTable.AutoFill( table, {
        columnDefs: [ {
            targets: -1,
            step: function ( cell, read, last, i, x, y ) {
                var val = parseInt( (last || read).replace(/[$,]/g, ''), 10 );
                val += (x<0 || y<0 ? -100 : 100); // - if going back up, + if going down
 
                // Format for the currency column
                return '$'+val.toString().replace( /\B(?=(\d{3})+(?!\d))/g, ',' );
            }
        } ]
    } );
} );

In addition to the above code, the following Javascript library files are loaded for use in this example:

Other examples

Examples

Please refer to the DataTables documentation for full information about its API properties and methods.
Additionally, there are a wide range of extras and plug-ins which extend the capabilities of DataTables.

DataTables designed and created by SpryMedia Ltd © 2007-2014
DataTables is licensed under the MIT license.