DataTables core
DataTables provides a comprehensive set of options and styling integrations to display tabular data in a way that integrates seamlessly with your web-site. It also has a flexible and expressive API for interacting with the data that it is displaying.
This section of the manual covers all of the basics for how to install and run DataTables, through to more advanced topics such as using the API and working with events. Everything DataTables starts here!
Sections
Installation
How to get DataTables up and running on your web-site. This section details the requirements DataTables has of your HTML tables, what files you need to include to have DataTables enhance your tables, how to include them and how to run DataTables. You'll be up and running in less than two minutes! Read more »
Data
Data is complex, and all data is different. Accordingly, DataTables has a wealth of options which can be used to configure how it will obtain the data to display in the table, and how it processes that data. This section of the manual describes the options to configure DataTables to read data from your data source. Read more »
Ajax
This section of the manual looks in detail at how to load Ajax sourced data into your DataTables with a JSON data source. This is comprised primarily of two tasks - where the array for the rows of data is in the JSON and the data point to be used for each column. Read more »
Usage
DataTables' huge range of options can be used to customise the way that it will present its interface, and the features available, to the end user. This section of the manual details how this configuration can be performed. A full list of the options available is shown in the options reference section of this web-site. Read more »
API
The DataTables API presents a wealth of options for accessing the data contained in a table, and otherwise manipulating the table programmatically. These functions range from selecting rows, columns and cells to get and set their data, to changing column visibility and applying search terms to the table dynamically. Read more »
Search
Search is a key part of DataTables and its goal of making data accessible. As such it has a number of search capabilities built in as well as presenting options to customise the search and APIs to allow advanced and case specific search operations. This document will discuss in detail how search is performed in DataTables. Read more »
Styling
It is important to style the DataTables enhanced tables in a manner which suits your design, so the tables fit in seamlessly with the rest of your site / app. To this end, DataTables provides a number of options for styling the tables, including its own customisable CSS, integration with CSS frameworks such Bootstrap and Foundation and pre-built themes. Read more »
Events
Knowing when DataTables has performed an operation can often play an important role in a complex and dynamic web-application. For this reason, DataTables will fire custom DOM events, which can be listened for using the DataTables API. Read more »
Server-side processing
Server-side processing allows DataTables to leverage the abilities and sheer power of database engines directly, to allow them to do the heavy work of ordering, searching and paging data. This is done by making an Ajax call for each page to be displayed by DataTables and is suited for very large datasets. Read more »
Internationalisation
DataTables adds several controls to a document when it enhances a table, many of which utilise language strings in one way or another to convey the usage to the end user. These default strings are in English, but can easily be translated into another language, or the strings customised. There are over 50 translations provided by the community ready to be used. Read more »
Security
Security is a fundamental topic in web-development and is a topic that should not be overlooked by any developer, from interns to CTOs. High profile hacking cases are frequently in headlines around the world, but with some careful thinking and planning you can quickly create secure applications. This page discusses web security attacks that are directly relevant to DataTables, along with methods for how you can combat them. Read more »
jQuery
The documentation on this page discusses how DataTables can be used with jQuery. DataTables had a hard dependency on jQuery, until the release of DataTables 3, at which point DataTables had zero external dependencies. Although DataTables no longer requires jQuery, it still will operate with jQuery in exactly the same way as it did with earlier versions. Read more »
Plug-in development
As flexible as DataTables is, there may be times when you wish to customise certain aspects to your specific needs. DataTables has a number of plug-in and extension options which are detailed in this section. Read more »
Technical notes
Technical notes contain information about DataTables that doesn't quite fit into the flow of the rest of the documentation, explaining error messages, technical decisions regarding the implementation of DataTables and detailed explanations of other general topics of interest when working with DataTables. Read more »
Case studies
Read the stories of other developers using DataTables to create applications and web-pages for their clients. Read more »
Development
As open source software, DataTables is free for you to investigate its source, and I would very much encourage you to do so and contribute any changes you make back to the project so others can also benefit. This section of the manual describes how you can build DataTables from source, contribute code and the planned road map for DataTables. Read more »