Since: Buttons 1.0.0

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


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.


function buttons).disable()


Disable the selected button.


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


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();