afdf67075d
DataTables which character is used as a decimal place in the table's data, so that number which are formatted using characters other than a dot as the decimal place can be correctly detected and sorted. - A large part of the world uses the comma as a decimal place, so it makes sense to have this option built-in directly to DataTables, rather than needing to use plu-in sorting types as before: http://en.wikipedia.org/wiki/Decimal_mark - However, the decimal place character cannot be detected automatically since there are far to many ambiguities. As such, a new `language.decimal` option is defined which is passed through to the type detection functions. The type detection functions can then use that character to alter their detection functions to transform numbers into the dot formatted equivilent for parsing in Javascript. - The numeric sorting methods have been bundled together in the function `_addNumericSort` which is called when a character is given for the decimal mark, adding the sorting functions required specifically for that mark. This means that any character at all can be added, while keeping the table's sort performance as it was. - Code size in increased a little for this new feature, but a lot of work has been done to keep it to a minimum (while still optimising for the most common use case of a dot decimal place), and this is a good feature to have in DataTables' core code. - All required documentation added and updated. - Special thanks to Tobias Bäthge for suggesting and sponsoring this feature. |
||
|---|---|---|
| examples | ||
| media | ||
| .datatables-commit-sync | ||
| .gitignore | ||
| bower.json | ||
| composer.json | ||
| Contributing.md | ||
| dataTables.jquery.json | ||
| license.txt | ||
| package.json | ||
| Readme.md | ||
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.
Installation
In most cases, to use DataTables all you need to do is include jQuery, the DataTables Javascript and DataTables CSS files in your HTML page:
<link rel="stylesheet" type="text/css" href="//cdn.datatables.net/1.10.0-beta.1/css/jquery.dataTables.css">
<script type="text/javascript" language="javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<script type="text/javascript" language="javascript" src="//cdn.datatables.net/1.10-beta.1/js/jquery.dataTables.js"></script>
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 pug-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 /*!.