自动填充
自: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 )
- 参数
名称 类型 可选项 1 e
否 jQuery 事件对象
2 datatable
否 DataTables API 实例表示已经完成 AutoFill 的表
3 cells
否 自动填充的单元格矩阵。关于详细信息请参阅上面的说明。
示例
当自动填充完成时显示一条消息
var table = new DataTable('#myTable');
table.on('autoFill', function (e, datatable, cells) {
alert(cells.length * cells[0].length + ' cells were updated');
});