page
Page change event - fired when the table's paging is updated.
Description
The page
event is fired the table's paging state changes. This can be the end user selecting the page to view or the page length from the built-in controls, 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.
Please note that, as with all DataTables emitted events, this event is 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:
-
Name Type Optional 1 e
No jQuery event object
2 settings
No DataTables settings object
Example
Show information about the current page using the API:
1
2
3
4
5
6
|
var table = $( '#example' ).DataTable(); $( '#example' ).on( 'page.dt' , 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.
Post new comment
Contributions in the form of tips, code snippets and suggestions for the above material are very welcome. To post a comment, please use the form below. Text is formatted by Markdown.
To post comments, please sign in to your DataTables account, or register:
Any questions posted here will be deleted without being published.
Please post questions in the Forums. Comments are moderated.