page.info()
Get paging information about the table.
Description
The paging state of the table can often be useful to understand what data is being displayed in a table at any given time - indeed it can even be useful when paging
is disabled to get information about the number of records in the table.
This method provides information about the table's paging state, and information about the number of records in the table (both total and in the search result set).
The returned object has the following properties:
page
- Current page index (zero based - i.e. the first page is0
)pages
- Total number of pagesstart
- Display index for the first record shown on the current pageend
- Display index for the last record shown on the current pagelength
- Display length (number of records). Note that generallystart + length = end
, but this is not always true, for example if there are only 2 records to show on the final page, with a length of 10.recordsTotal
- Full data set lengthrecordsDisplay
- Data set length once the current search criteria has been applied.serverSide
- A boolean value that indicates if the table is operating in server-side processing mode or not (serverSide
). This can be useful when working with paging and the API as index results can be offset by the display start point.
Example returned object:
{
"page": 1,
"pages": 6,
"start": 10,
"end": 20,
"length": 10,
"recordsTotal": 57,
"recordsDisplay": 57,
"serverSide": false
}
Type
function page.info()
- Description:
Get information about the table's paging state. Note that if multiple tables are available in the API's context, the page length of the first table in the context will be used. Use
table()
if you are working with multiple tables in a single API context.- Returns:
Object (described below) with information about the table's paging state.
Example
Get the current page and number of records in the table:
var table = new DataTable('#myTable');
var info = table.page.info();
$('#tableInfo').html(
'Currently showing page ' + (info.page + 1) + ' of ' + info.pages + ' pages.'
);
Related
The following options are directly related and may also be useful in your application development.