{hero}

preInit

自:DataTables 1.10.8 起

初始化開始事件 - 在資料載入前立即觸發。

描述

當表格正在初始化且即將請求資料時,DataTables 會發出此事件。在觸發時,表格將會初始化其欄位和功能,但尚未載入任何資料(無論是透過 Ajax 還是從 DOM 讀取)。

其主要目的是允許 DataTables 擴充功能的作者新增文件監聽器,以便在資料載入之前採取一些動作(例如修改要載入的資料量)。

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

類型

function function( e, settings )

參數

範例

設定要顯示的資料長度為 20 個項目

$(document).on('preInit.dt', function (e, settings) {
	var api = new DataTable.Api(settings);

	api.page.len(20);
});

new DataTable('#myTable');

相關

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