{hero}

初始化

自:DataTables 1.10 起

初始化完成事件 - 當 DataTables 完全初始化並載入資料後觸發。

描述

init 事件是 initComplete 初始化選項的事件互補。與回呼函式一樣,當您的表格完全初始化、資料載入和繪製後,就會呼叫 init 事件,當使用 ajax 資料來源時,這會特別有用。在這種情況下,表格將在資料載入之前完成其初始執行(畢竟 Ajax 是非同步的!),因此提供此回呼函式,讓您知道資料何時完全載入。

init 事件與 initComplete 在同一時間點觸發(技術上,回呼函式會在事件之前觸發,但它們會依序發生,因此可以使用其中任何一個來達到相同的效果)。

請注意,與所有 DataTables 發出的事件一樣,事件物件在其上具有可用的 DataTables API 實例(第一個參數)。此外,事件會使用 dt 命名空間觸發。因此,要監聽此事件,您還必須使用 dt 命名空間,只需將 .dt 附加到您的事件名稱,如下例所示。

此事件將會向上冒泡到文件,因此您可以將 init.dt 的監聽器添加到 body 以捕獲 DataTables 觸發的所有初始化事件。

類型

function function( e, settings, json )

參數

範例

使用 API 顯示目前排序的資訊

console.log('Table initialisation start: ' + new Date().getTime());

$('#example')
	.on('init.dt', function () {
		console.log('Table initialisation complete: ' + new Date().getTime());
	})
	.DataTable();

相關

以下選項直接相關,並且在您的應用程式開發中也可能很有用。