on()

自 DataTables 1.10 版本起

表格事件監聽器。

說明

DataTables 可以觸發許多事件，這些事件在 DataTables 執行時對於採取動作很有用。例如，通常會希望知道何時發生 Ajax 事件 (xhr)，以便您可以將其他資料添加到 JSON 負載中。

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);
});

on()

說明

類型

function on( event, callback )

範例

相關

DataTables