{hero}

selected

Since: Select 1.0.0

Button that is enabled when one or more items are selected in the table.
Please note - this property requires the Select extension for DataTables.

Description

When working with item selection in a DataTable you will typically wish to provide your end users with the ability to take some kind of action when items are selected. This button provides a basic framework for that, as it is dynamically enabled and disabled automatically as items in the table are selected.

By providing an action function (buttons.buttons.action / button().action()) this button can be used to perform whatever operation is required on the table and its selected items.

Example

DataTables initialisation: Count the number of selected rows:

$('#myTable').DataTable( {
	buttons: [
		{
			extend: 'selected',
			text: 'Count selected rows',
			action: function ( e, dt, button, config ) {
				alert( dt.rows( { selected: true } ).indexes().length +' row(s) selected' );
			}
		}
	]
} );