trigger()

自：DataTables 2.0 起

触发一个事件。

描述

DataTables 扩展作者使用此方法，让事件触发的形式与 DataTables 内部触发的方式保持一致。事件对于让开发人员了解某个操作已经发生以及他们可以执行其他操作非常有用。例如，当某个按钮处理一个操作或者一个操作已经发生时，Buttons 扩展会触发事件。

与其他 DataTables 事件一样，使用此方法触发的任何事件都将附加 .dt 命名空间（用于 jQuery 名称空间处理）。此外，使用 table 元素作用域为 DataTables 执行事件处理程序，并且 event 对象附加了一个包含 DataTables API 实例的 dt 属性。

默认情况下，触发的事件不冒泡到文档中，因为该操作会影响性能。然而，可以使用可选的第三个参数启用冒泡。如果启用了冒泡且 table 不在文档中，事件仍会在 body 元素上触发。

类型

function trigger( name, args [, bubbles ] )

描述

触发与 DataTables 相关的事件。

参数

	名称	类型	可选
1	`name`	`string`	否
	事件名称。
2	`args`	`array`	否
	要发送到事件的参数阵列。
3	`bubbles`	`boolean`	是 - 默认值：false
	指示事件是否以 DOM 事件通常执行的方式在文档中冒泡。事件冒泡会导致性能受到影响。

返回

DataTables.Api

一个包含事件处理程序返回的值的结果集。可以用来检查事件是否被标记为 false 而被取消（例如）。

示例

监听和触发自定义事件

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

table.on('customEvent', function (e, length, start) {
	console.log(length, start);
	// would print `1, 0`
});

table.trigger('customEvent', [1, 0]);

自定义事件中访问 DataTables API

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

table.on('customEvent', function (e) {
	let info = e.dt.page.info();

	console.log(info);
});

table.trigger('customEvent');