trigger()

自：DataTables 2.0 起

觸發事件。

描述

這個方法是專為 DataTables 擴充功能作者設計的，讓他們能夠以 DataTables 內部相同的方式觸發事件。事件對於讓開發人員知道已發生特定動作且可以執行其他操作很有用。例如，當按鈕正在處理動作或已發生動作時，Buttons 擴充功能會觸發事件。

與其他 DataTables 事件一樣，使用此方法觸發的任何事件都會附加 .dt 命名空間（用於 jQuery 命名空間處理）。此外，事件處理程序會在 DataTable 的 table 元素的作用域內執行，並且 event 物件會附加一個 dt 屬性，其中包含 DataTables API 實例。

預設情況下，觸發的事件不會向上冒泡到文件，因為該操作會影響效能。但是，可以使用選用的第三個參數啟用冒泡。如果啟用，並且 table 不在文件中，則事件仍會在 body 元素上觸發。

類型

function trigger( name, args [, bubbles ] )

描述

觸發與 DataTables 相關的事件。

參數

	名稱	類型	選用
1	`name`	`字串`	否
	事件名稱。
2	`args`	`陣列`	否
	要傳遞給事件的引數陣列。
3	`bubbles`	`布林值`	是 - 預設值：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');