{hero}

自:KeyTable 2.0.0 起

启用并配置 DataTables 的 KeyTable 扩展。
请注意 - 此属性需要适用于 DataTables 的 KeyTable 扩展。

描述

KeyTable 是 DataTables 的一款扩展,在表中提供类似电子表格的键盘导航,可以使用箭头键、Tab 键、Home 键、End 键和翻页键(向上/向下)移动焦点所在的单元格。当用户在表中导航时,KeyTable 会自动调整表的分页和其他参数,以将焦点所在的单元格显示出来。结合 编辑器 使用,它会更加轻松地在浏览器中创建类似 Excel 的用户界面。

此选项可以为 DataTables 启用和配置 KeyTable。其最简单的形式是布尔值 true,它将启用 KeyTable 并采用默认配置选项($.fn.dataTable.KeyTable.defaults 定义)。它也可以用作一个对象,用来提供自定义配置选项,如下所述。

请注意,正如 KeyTable 的所有其他配置选项一样,此选项是对 DataTables 选项默认设置 的一种扩展。此属性应在 DataTables 初始化对象中进行设置。

类型

布尔值

描述

作为布尔值,此属性将在正在创建的 DataTable 上启用 KeyTable。true 将启用 KeyTable,而 false 则不会。

这是一个捷径选项,可使用默认配置选项启用 KeyTable。可以通过将此参数作为一个对象来进行定制,请见下文。

对象

描述

如果作为一个对象提供,KeyTable 会在目标 DataTable 上启用,并使用此对象中提供的选项扩展 KeyTable 的默认属性 ($.fn.dataTable.KeyTable.defaults)(有可能将其覆盖)。这就是 KeyTable 可以在单个表的级别或默认级别上得到配置的方式。

默认值

  • 值:undefined

KeyTable 默认不会初始化

实例

为一个表启用 KeyTable

new DataTable('#myTable', {
	keys: true
});

使用配置选项启用 KeyTable

new DataTable('#myTable', {
	keys: {
		columns: ':not(:first-child)'
	}
});