buttons().enable()

Since: Buttons 1.0.0

Enable / disable the selected buttons.
Please note - this property requires the Buttons extension for DataTables.

Description

It can often be useful to enable and disable buttons based on some external logic. A common example is an Edit button that is disabled when no rows are selected in a table.

When a button is disabled its visual appearance is updated to show its deactivated status (this is done by adding the class disabled to the button element). Additionally, when a disabled button is clicked on (or otherwise activated by the keyboard or button().trigger()) the button's action is not executed.

This method can be used to dynamically change the enabled state for the selected buttons.

Type

function buttons().enable( [ state ] )

Description:

Set the enabled state for the selected buttons.

Parameters:

	Name	Type	Optional
1	`state`	`boolean`	Yes - default:true
	Optional parameter that can be used to disable buttons when set to `false`. This can be useful for changing a buttons enabled state on a conditional operator.

Returns:

DataTables.Api

DataTables API instance with the selected buttons in the result set, available for chaining further operations on the buttons.

Examples

Enable all buttons:

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

table.buttons().enable();

Set enabled state on a logic condition:

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

table
	.buttons(['.edit', '.delete'])
	.enable(table.rows({ selected: true }).indexes().length === 0 ? false : true);