描述(Description)
DataTables可以触发很多事件,这些事件在DataTables执行对应事件可以采取相应的行动。比如说,知道当Ajax事件(
xhrEvent
)
何时发生是非常有用的,所以你可以添加额外的数据到JSON有效载荷。
DataTables提供了使用DataTables事件的三种方法,与jQuery核心事件方法相匹配:
one()
方法用于监听DataTables的事件,然后在第一次触发该事件后立即删掉监听。只要传递你想要监听的事件,并提供一个回调函数,当事件被DataTables触发时,它将被激活,然后被删除。
类型(Type)
这个选项能够接受以下类型的参数:
function one( event, callback )
描述(Description):
添加一个事件监听器,为此回调将被触发一次,然后删除事件侦听器
参数(Parameters):
名称(Name) | 类型(Type) | 是否可选(Optional) | |
---|---|---|---|
1 | event |
stringType
|
No |
用来监听事件。多个事件监听可以用空格分开也可以使用命名空间,就像 jQuery.on
|
|||
2 | callback |
functionType
|
No |
事件回调函数处理函数。 |
返回(Returns):
DataTables API 实例对象
例子(Example)
监听第一次 xhr
事件
1
2
3
4
5
6
7
8
var table = $('#example').DataTable( {
ajax: "/data",
serverSide: true
} );
table.one( 'xhr', function ( e, settings, json ) {
console.log( 'Ajax事件发生,返回的数据是: ', json );
} );
相关属性(Related)
下面的选项是直接相关的,也可能是您的应用程序的开发非常有用。
API