1
0
mirror of https://github.com/DataTables/DataTables.git synced 2024-11-28 10:24:10 +01:00
DataTables is a table enhancing plug-in for the jQuery Javascript library, adding sorting, paging and filtering abilities to plain HTML tables with minimal effort. https://datatables.net/
Go to file
Allan Jardine 9182f8c285 Fix: API performance improvement - sigifnicantly faster API access for large tables. Testing with a table of 50'000 rows rows().count() is now 23mS executation time, while it was 996mS before!
- The `_unique()` function was a killer because it uses nested loops to
  determine if items have been seen before in an array. In the majority
  of cases when accessing the API the items will be unique already, so
  running the nested loops is hugely detremental to performance.
- Rather than attempting to improve the performance of `_unique()`
  itself, we try to avoid running its algorithim at all. An array of the
  items is sorted and tested to see if there are unique items or not. In
  the majority of cases this means a massive performance boost since it
  is a single loop rather than a nested loop.
2017-04-14 21:10:23 +01:00
examples Fix - examples: Tighten up regex check to protect against LFI vulnerability 2017-04-12 20:00:44 +01:00
media Fix: API performance improvement - sigifnicantly faster API access for large tables. Testing with a table of 50'000 rows rows().count() is now 23mS executation time, while it was 996mS before! 2017-04-14 21:10:23 +01:00
.datatables-commit-sync Fix: API performance improvement - sigifnicantly faster API access for large tables. Testing with a table of 50'000 rows rows().count() is now 23mS executation time, while it was 996mS before! 2017-04-14 21:10:23 +01:00
.gitignore Add minified files to built repo 2014-06-23 15:40:22 +01:00
bower.json Dev: Remove the version attr from bower.json - bower doesn't use it any more 2016-02-11 14:29:00 +00:00
composer.json Fix - CSS: Columns which are orderable in a single direction only should show a pointer cursor 2017-04-07 11:04:03 +01:00
Contributing.md Update: Contributing documentation to direct support requests to the 2015-04-06 22:08:10 +01:00
dataTables.jquery.json Fix - CSS: Columns which are orderable in a single direction only should show a pointer cursor 2017-04-07 11:04:03 +01:00
ISSUE_TEMPLATE.md Dev: Update issue template to not use markdown 2016-05-16 12:31:28 +01:00
license.txt Update license.txt 2015-06-22 17:24:11 +02:00
package.json Update - CSS: Bootstrap 4 integration for alpha 6 changes 2017-04-05 15:35:53 +01:00
Readme.md Dev: Update readme to refer to the NPM and bower packages for DataTables 2016-02-11 10:27:45 +00:00

DataTables plug-in for jQuery

DataTables is a table enhancing plug-in for the jQuery Javascript library, adding sorting, paging and filtering abilities to plain HTML tables with minimal effort. The stated goal of DataTables is:

To enhance the accessibility of data in HTML tables.

To meet this goal, DataTables is developed with two distinct groups of users in mind:

  • You the developers using DataTables. For developers DataTables provides a wide array of options for how data should be obtained, displayed and acted upon, along with an extensive API for accessing and manipulating the table.

  • End users. For those using the interface DataTables presents, actions to get the most from the information contained in tables, such as sorting and filtering, along with paging and scrolling of the data in table, are easy to use, intuitive and fast.

Installing DataTables

To use DataTables, the primary way to obtain the software is to use the DataTables downloader. You can also include the individual files from the DataTables CDN. See the documentation for full details.

NPM and Bower

If you prefer to use a package manager such as NPM or Bower, distribution repositories are available with software built from this repository under the name datatables.net. Styling packages for Bootstrap, Foundation and other styling libraries are also available by adding a suffix to the package name.

Please see the DataTables NPM and Bower installation pages for further information. The DataTables installation manual also has details on how to use package managers with DataTables.

Usage

In its simplest case, DataTables can be initialised with a single line of Javascript:

$('table').dataTable();

where the jQuery selector is used to obtain a reference to the table you want to enhance with DataTables. Optional configuration parameters can be passed in to DataTables to have it perform certain actions by using a configuration object as the parameter passed in to the DataTables constructor. For example:

$('table').dataTable( {
  paginate: false,
  scrollY: 300
} );

will disable paging and enable scrolling.

A full list of the options available for DataTables are available in the documentation.

Documentation

Full documentation of the DataTables options, API and plug-in interface are available on the DataTables web-site. The site also contains information on the wide variety of plug-ins that are available for DataTables, which can be used to enhance and customise your table even further.

Support

Support for DataTables is available through the DataTables forums and commercial support options are available.

License

DataTables is release under the MIT license. You are free to use, modify and distribute this software, as long as the copyright header is left intact (specifically the comment block which starts with /*!.