key-focus
自:KeyTable 2.0.0
KeyTable 已对单元格进行了对焦。
请注意 - 此属性需要 KeyTable 扩展用于 DataTables。
说明
当 KeyTable 对单元格进行对焦时触发 key-focus
事件。这可能是以下结果
- 用默认对焦初始化 (
keys.focus
) - 鼠标与用户交互(单击单元格)
- 键盘与用户交互(移动对焦)
- API 对焦 (
cell().focus()
).
在单元格对焦时了解对其进行操作非常有用。例如,您可能需要显示有关单元格的其他信息,调整单元格的样式或为最终用户启用更多交互选项。
此事件会在 key-blur
事件(如果有待模糊的单元格 - 即两个单元格绝不会同时对焦)之后发生。
此外,此事件不会在已对焦的单元格上触发 - 即对焦的单元格在失去对焦之前不能再次获得对焦。如果需要知道对焦何时触发已对焦单元格,请参阅 key-refocus
以获取合适的事件。
类型
函数 function( e, datatable, cell, originalEvent )
- 参数
名称 类型 可选 1 e
否 jQuery 事件对象
2 datatable
否 此表可查询的 DataTable API 实例
3 cell
否 包含已对焦单元格的 DataTables API 实例 (
cell()
)4 originalEvent
否 触发此对焦的原始事件。它可能是
- 一个 DOM
click
点击事件 - 例如单击以对焦单元格 - 一个 DOM
focus
焦点事件 - 例如使用 tab 键绕过页面以及 tab 键到表格。 null
:没有原始事件 - 例如在使用cell().focus()
时。
- 一个 DOM
示例
在对焦改变时显示有关单元格的信息
var table = new DataTable('#myTable', {
keys: true
});
table
.on('key-focus', function (e, datatable, cell, originalEvent) {
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');
});
相关
以下选项直接相关,在您的应用程序开发中也可能有用。