key-blur
KeyTable has blurred focus from a cell.
Please note - this property requires the KeyTable extension for DataTables.
Description
While it is often useful to know when a cell gains focus (key-focus
) it is equally useful to know when that cell loses focus. This event provides that ability and is triggered whenever a cell's focus is blurred. This can be the result of:
- Focus moving to a different cell
- Focus leaving the table (
keys.blurable
).
This event will occur prior to the key-focus
event (if there is a cell to be blurred - i.e. two cells can never have focus at the same time). Additionally, if a DataTables page change is required to display a newly focused cell, this event will occur before the page change is triggered.
Type
function function( e, datatable, cell )
- Parameters:
Name Type Optional 1 e
No jQuery event object
2 datatable
No DataTable API instance for the table in question
3 cell
No A DataTables API instance that contains the cell that was blurred (
cell()
)
Example
Show information about a cell when focus is changed:
var table = new DataTable('#myTable', {
keys: true
});
table
.on('key-focus', function (e, datatable, cell) {
var rowData = datatable.row(cell.index().row).data();
$('#details').html('Cell in ' + rowData[0] + ' focused');
})
.on('key-blur', function (e, datatable, cell) {
$('#details').html('No cell selected');
});
Related
The following options are directly related and may also be useful in your application development.