{hero}

自动填充

自:AutoFill 2.0.0

自动填充操作已经完成。
请注意 - 此属性需要 AutoFill DataTables 的扩展程序。

说明

当最终用户完成填充操作时触发此事件。发生在表被更新并通过填充绘制之后。此功能非常适合将更改提交到服务器/数据库,永久存储更改。

以阵列(如下所述的 cells 参数)提供已填充单元格的信息 - 这是个包含阵列的阵列,每个顶层阵列代表一行而内部元素就是列 - 例如

[
    [ cell_0-0, cell_0-1, cell_0-2, ... ],
    [ cell_1-0, cell_1-1, cell_1-2, ... ],
    [ cell_2-0, cell_2-1, cell_2-2, ... ],
    ...
]

始终保证至少有一个单元格 - 所以可以安全地访问 [0][0] 作为第一个单元格。第一个单元格是填充开始的地方。第一行列与该单元格处于同一轴,不管填充是向上、向下、向左还是向右。

每个内部阵列项表示单元格的一个对象并包含以下属性

  • cell - 相关单元格的数据表 API 实例 - 参阅 cell()
  • index - 单元格的索引 - 参阅 cell().index() - 这是 数据表的内部索引,而不是可见索引!
  • data - 填充前的单元格数据
  • set - 填充后的单元格数据

类型

function function( e, datatable, cells )

参数

示例

当自动填充完成时显示一条消息

var table = new DataTable('#myTable');

table.on('autoFill', function (e, datatable, cells) {
	alert(cells.length * cells[0].length + ' cells were updated');
});