按钮集按钮的按键

自：按钮 3.0.0

定义按钮的激活按键。
请注意 - 此属性需要 DataTables 的按钮扩展。

描述

按钮具有通过键盘按键和组合键激活按钮的内置功能。这有助于辅助功能并提供完整键盘导航您的表格。例如，使用编辑器可以添加、编辑和删除记录而不接触鼠标！

仅在文档没有任何处于活动焦点的元素时才处理按键。这意味着键入input元素不会意外触发按钮的操作！

类型

string

描述: 作为字符串，此选项将设置要监听的键。它应该是单个字符（因为不能同时按下多个字符！）。字符不区分大小写。

object

描述

此选项的对象形式提供了对哪些键将激活特定按钮的附加控制，提供按元键（如 shift、alt 和 ctrl）过滤的选项。

可用的对象属性为

key - 要侦听的字符。字符不区分大小写。
shiftKey - 当设置为 true 时，仅当同时按住shift键时才会激活。
altKey - 当设置为 true 时，仅当同时按住alt键时才会激活。
ctrlKey - 当设置为 true 时，仅当同时按住ctrl键时才会激活。
metaKey - 当设置为 true 时，仅当同时按住 cmd 键（Mac）或 Windows 键（Windows）时才会激活。

如果您希望将激活限制为特定、复杂的按键组合，则可以定义多个选项。

默认

值：undefined

示例

DataTables 初始化：为按钮设置一个键

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [{ extend: 'print', key: 'p' }]
		}
	}
});

DataTables 初始化：需要 Alt 键

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [
				{
					extend: 'print',
					key: {
						key: 'p',
						altKey: true
					}
				}
			]
		}
	}
});