buttons().action()
Get / set the action functions for the selected buttons.
Please note - this property requires the Buttons extension for DataTables.
Description
This method provides the ability to get or set the action function of the selected buttons. The action function (which can be set on initialisation by buttons.buttons.action) defines what the button will do when activated.
Please note that when setting an action, the new function will replace any action that the button already has assigned to it. This is an important consideration as many button types define their own action that would no longer be executed if replaced.
Types
buttons().action()
Get the action functions for the selected buttons.
Returns:
DataTables.Api
DataTables API instance which contains the action functions for the selected buttons
buttons().action( set )
Set the action functions for the selected buttons.
Parameters:
| Name | Type | Optional | |
|---|---|---|---|
| 1 | set | No | |
Function to set for the selected button's action method, replacing any action that was previously assigned to the buttons. The same function is used for all selected buttons. The function takes four parameters:
No return value is expected. The function is executed with in the scope of a DataTables API instance for the selected button (i.e. | |||
Returns:
DataTables.Api
DataTables API instance with the selected buttons in the result set, available for chaining further operations on the buttons.
Example
Set a simple action function for all buttons:
var table = new DataTable('#myTable');
table.buttons().action(function (e, dt, button, config) {
console.log('Button ' + this.text() + ' activated');
this.disable();
});