on()

自 DataTables 1.10

表格事件侦听器。

描述

DataTables 会触发一些事件，当 DataTables 执行这些事件时，利用这些事件来执行操作很有用。例如，了解何时发生 Ajax 事件 (xhr) 经常很有用，这样可以向 JSON payload 添加附加数据。

DataTables 提供了三种与 DataTables 事件结合使用的方法，它们与核心的 jQuery 事件方法相匹配

on() - 侦听事件
off() - 停止侦听事件
one() - 侦听单个事件。

此 on() 方法用于开始侦听 DataTables 事件。只需传入想要侦听的事件，并提供一个当 DataTables 触发该事件时将被激活的回调函数即可。

类型

function on( event, callback )

描述

侦听来自表格的事件，并在这些事件发生时触发回调

参数

	名称	类型	可选
1	`event`	`字符串`	否
	要侦听的事件。可以使用空格分隔符来侦听多个事件，事件名称可以使用命名空间，就像使用 `jQuery().on()` 一样。
2	`callback`	`功能`	否
	事件回调处理程序。有关传入的论点列表，请参阅正在使用的事件的文档。

返回

DataTables.Api

DataTables API 实例

示例

在每次 xhr 事件中记录一条控制台消息

var table = new DataTable('#myTable', {
	ajax: '/data.json'
});

table.on('xhr', function (e, settings, json) {
	console.log('Ajax event occurred. Returned data: ', json);
});

关联

以下选项直接相关，在你的应用程序开发中也可能有用。

API