scroller

Enable and configure the Scroller extension for DataTables.
Please note - this property requires the Scroller extension for DataTables.

Description

Scroller is an extension for DataTables that provides virtual rendering support - i.e. it will draw only the small visible section of the table (plus a small overlap for smooth scrolling), even although in the scrolling viewport it will appear visually to the end user that the whole table is available. This can significantly improve performance for large data sets where you don't wish to display paging controls.

There are two important requirements to consider when using Scroller:

• Paging must be enabled in DataTables (paging - it is by default)
• All rows must be of equal height. This is to allow row height calculations for rows which have not yet been rendered.

This option provides the ability to enable and configure Scroller for DataTables. In its simplest form as the boolean true it will enable Scroller with the default configuration options (as defined by $.fn.dataTable.Scroller.defaults). It can also be used as an object to provide custom configuration options as described below.

Please note that as with all other configuration options for Scroller, this option is an extension to the default set of DataTables options. This property should be set in the DataTables initialisation object.

Types

Default

• Value: undefined

Scroller will not be initialised by default

Examples

new DataTable('#myTable', {
	ajax: '/api/data',
	scrollY: 300,
	scroller: true
});

new DataTable('#myTable', {
	ajax: '/api/data',
	scrollY: 300,
	scroller: {
		loadingIndicator: true
	}
});