keys.enable()
自:KeyTable 2.0.0
启用或禁用 KeyTable 的交互(鼠标和键盘)。
请注意 - 此属性需要 KeyTable 扩展用于 DataTables。
描述
KeyTable 通常用作 DataTable 其他交互选项的启用器,例如编辑单元格的内容或触发将显示有关单元格或行的其他信息的动作。在这种情况下,重要的是我们能够控制 KeyTable 自身的侦听器,以便根据需要精细地控制其作用的按键。此方法提供了该功能。
当 KeyTable 完全启用时,如果某个单元格具有焦点,它将侦听所有非特殊字符按键(即忽略 shift、cmd/ctrl 和 alt)并触发 key
事件。但是,您可能希望让 KeyTable 停止侦听某些事件,例如在编辑字段时输入字母。要提供此功能,该方法接受一个可选参数,它将告知 KeyTable 您希望它侦听和采取措施的侦听器级别。
请注意,KeyTable 的按键侦听器在 keydown
事件中触发,如果 KeyTable 对按键执行动作(例如移动焦点),它将自动调用该事件的 stopPropagation()
方法。
类型
函数 keys.enable( [ 选项 ] )
- 描述
启用最终用户和 API 对 DataTable 中已聚焦单元格的修改。可通过可选参数获得不同的启用级别。
- 参数
名称 类型 可选 1 选项
是 - 默认为 true 该选项可赋予以下值
true
- 完全启用 KeyTablefalse
- 完全禁用 KeyTable (keys.disable()
)navigation-only
- 仅响应导航输入
- 返回
DataTables API 实例
示例
仅允许导航(即字母键不执行任何操作,也不触发任何事件)
var table = new DataTable('#myTable', {
keys: true
});
table.keys.enable('navigation-only');
相关
以下选项直接相关,在您的应用程序开发中可能也有用。