dataTable() vs. DataTable() – why is there a difference and how do I make them work together?

by

Basically, the two constructurs return different objects.

dataTable constructor

var table = $(<selector>).dataTable()

dataTable is the oldschool dataTables constructur, which returns a jQuery object. This jQuery object is enriched with a set of API methods in hungarian notation format, such as fnFilter, fnDeleteRow and so on. See a complete list of API methods here. Examples :

table.fnDeleteRow(0); 
table.fnAddData(['E', 'F']);

dataTable is supported by all 1.9.x / 1.10.x versions.

DataTable constructor

var table = $(<selector>).DataTable()

The DataTable constructor was introduced in 1.10.x, and returns a huge API object with full read/write access to pages, rows, cells and more, see manual. Example equivalences :

table.row(0).remove();
table.row.add(['E', 'F']).draw();

Combining dataTable and DataTable

If you maintain old code, or for some reason need to use the oldschool dataTable constructor, but still needs to use the new API, the jQuery object is extended (from 1.10.0) with a .api() method that returns the new API. Example equivalences :

var table = $('#example').dataTable();
table.api().row(0).remove();
table.api().row.add(['E', 'F']).draw();

The old API like table.fnDeleteRow(0) still works. So to your concern :

Essentially I need the multi-filter-select functionality, but also
need to tack on some other calls / plugins, which don’t seem to like
the upper-case ‘D’ initialization.

As you see, you can do both! Initialize dataTables the old way, and use .api() when you need access to the new API.

Why is so many official examples using dataTable()?

Well, you do not need to use the DataTable constructor. If you dont use the new API, there is no reason for using the DataTable constructur. The oldschool dataTable constructor is not deprecated. DataTables is mostly one mans work. It is a huge task to maintain and develop and obviously very time consuming to maintain a huge website with forum, manuals, tons of examples and so on. This is only a guess, but I assume Allan Jardine by now only have changed dataTable to DataTable where it is actually needed, simply bacause he cant do it all in one step.

More Related Contents:

  1. Datatables: Change cell color based on values
  2. DataTables warning: Requested unknown parameter ‘0’ from the data source for row ‘0’
  3. How print in Jquery / Datatables [closed]
  4. How to reload/refresh jQuery dataTable?
  5. TypeError: $(…).DataTable is not a function
  6. jQuery DataTables – Filter column by exact match
  7. When using Ajax with jQuery DataTables, how do I determine what to do with the data returned?
  8. jQuery DataTables server-side processing using ASP.NET WebForms
  9. Detect page change on DataTable
  10. DataTables row.add to specific index
  11. Datatables: Cannot read property ‘mData’ of undefined
  12. make column data as hyperlink (dataTable JQUERY)
  13. How to export all rows from Datatables using Ajax?
  14. How do I add button on each row in datatable?
  15. DataTables – Not working when added colspan for the last column
  16. jQuery plugin DataTables: How to highlight the current search text?
  17. jQuery DataTables Getting selected row values
  18. Download csv file as response on AJAX request
  19. Implement JQuery Datatable in ASP.NET GridView
  20. How to implement hierarchical multilevel datatable in javaScript?
  21. Datatables warning(table id = ‘example’): cannot reinitialise data table
  22. How to sort by Date with DataTables jquery plugin?
  23. jQuery dataTable doesn’t show sort icon
  24. How to add Rowspan in JQuery datatables
  25. How to submit checkboxes from all pages with jQuery DataTables
  26. Primefaces DataTable, lazy loading and CommandButton per row
  27. How can I search multiple columns in DataTables?
  28. RStudio Shiny list from checking rows in dataTables
  29. DataTables js, how to use `ajax` option with a `callback` function?
  30. DataTables fixed headers misaligned with columns in wide tables

Leave a Comment