初始化
自: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 )
- 參數
名稱 類型 可選 1 e
否 jQuery 事件物件
2 settings
否 DataTables 設定物件
3 json
否 如果使用 Ajax 載入資料,則從伺服器檢索的 JSON 資料
範例
使用 API 顯示目前排序的資訊
console.log('Table initialisation start: ' + new Date().getTime());
$('#example')
.on('init.dt', function () {
console.log('Table initialisation complete: ' + new Date().getTime());
})
.DataTable();
相關
以下選項直接相關,並且在您的應用程式開發中也可能很有用。