键
启用并配置 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)'
}
});