{hero}

button().disable()

Since: Buttons 1.0.0

Disable the selected buttons.
Please note - this property requires the Buttons extension for DataTables.

Description

It can often be useful to enable and disable a button based on some external logic. A common example is an editing 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 disable a single button. Unlike its counterpart method, button().enable(), this method cannot be used to both enable and disable a button, it can only be used to disable.

Type

function buttons().disable()

Description:

Disable the selected buttons.

Returns:

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

Examples

Disable button index 2-1:

var table = $('#myTable').DataTable();

table.button( '2-1' ).disable();

Set enabled state on a logic condition:

var table = $('#myTable').DataTable();

if ( table.rows( { selected: true } ).indexes().length === 0 ) {
	table.button( 'edit:name' ).disable();
}
else {
	table.button( 'edit:name' ).enable();
}