{hero}

one()

自 DataTables 1.10 起

监听一次数据表事件,然后移除监听器。

说明

DataTables 可以触发许多事件,当 DataTables 执行这些事件时,这些事件可以用来执行操作。例如,通常在发生 Ajax 事件 (xhr) 时了解该信息会很有帮助,以便你可以将其他数据添加到 JSON 有效内容。

DataTables 提供三种方法来使用 DataTables 事件,与核心 jQuery 事件方法相匹配

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

one() 方法用于监听一次 DataTables 事件,然后在该事件第一次触发后立即移除该事件。只需指定要监听的事件,并提供在 DataTables 触发该事件时激活(然后移除)的回调函数。

类型

函数 one( event, callback )

说明

添加事件监听器,该监听器只触发一次,然后移除。

参数
返回值

DataTables API 实例

示例

只监听来自 DataTables 的第一个 xhr 事件

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

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

相关信息

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