{hero}

page

Since: DataTables 1.10

Page change event - fired when the table's paging is updated.

Description

The page event is fired when table's paging state changes. This can be the end user selecting the page to view, or when the page state is altered by the API (page()).

Note that the page will be fired before the table has been redrawn with the updated data.

If your table offers the user the ability to change the page length, you might also want to listen for length to know when the page length has changed.

Please note that, as with all DataTables emitted events, the event object has a DataTables API instance available on it (the first parameter). Additionally, the events are triggered with the dt namespace. As such, to listen for this event, you must also use the dt namespace by simply appending .dt to your event name, as shown in the example below.

Type

function function( e, settings )

Parameters:

Example

Show information about the current page using the API:

var table = new DataTable('#myTable');

table.on('page', function () {
	var info = table.page.info();

	$('#pageInfo').html('Showing page: ' + info.page + ' of ' + info.pages);
});

Related

The following options are directly related and may also be useful in your application development.