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
function buttons().action()
- Description:
Get the action functions for the selected buttons.
- Returns:
DataTables API instance which contains the action functions for the selected buttons
function buttons().action( set )
- Description:
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:
object
Event object that triggered the eventDataTables.Api
A DataTables API instance for the host DataTablejQuery
jQuery instance for the button node that was clicked onobject
The button's configuration object
No return value is expected.
The function is executed with in the scope of a DataTables API instance for the selected button (i.e.
button()
) for the button in question.- Returns:
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();
});