stateLoadParams

狀態載入事件 - 從儲存空間載入狀態時觸發。

描述

stateLoadParams 事件是 stateLoadParams 初始化選項的事件互補。與回呼函數一樣，該事件會在表格從儲存的資料載入狀態時觸發，但在將讀取的資料應用到資料表之前觸發。這允許修改已儲存的狀態資料。有關儲存的資料格式，請參閱 stateSaveCallback 文件。

stateLoadParams 事件會在與 stateLoadCallback 相同的時間點觸發（技術上回呼函數會在事件之前觸發，但它們是依序發生的，因此兩者都可以用於實現相同的效果）。

請注意，與所有 DataTables 發出的事件一樣，事件物件上都有一個 DataTables API 實例（第一個參數）。此外，事件會以 dt 命名空間觸發。因此，若要監聽此事件，您也必須使用 dt 命名空間，只需在事件名稱後附加 .dt 即可，如下面的範例所示。

類型

範例

$('#example')
	.on('stateLoadParams.dt', function (e, settings, data) {
		data.search.search = '';
	})
	.DataTable();

相關

以下選項直接相關，也可能對您的應用程式開發有用。