{hero}

stateRestore.states().remove()

自:StateRestore 1.0.0 版本起

從 StateRestore 移除狀態。
請注意 - 此屬性需要 DataTables 的 StateRestore 擴充功能。

描述

此方法提供移除由 StateRestore 擴充功能管理的多個狀態的功能。

stateRestore.states().remove() 接受一個參數,skipModal,允許針對每個狀態略過確認視窗。skipModal 的預設值為 false,表示將顯示視窗。它會移除先前呼叫 stateRestore.states() 所檢索到的狀態。

將返回一個 DataTables API 實例,以便進行進一步的鏈式操作。

如果 stateRestoreConfig 組態物件的 remove 選項設為 false,則此 API 方法將不會執行任何操作。

類型

函式 stateRestore.states().remove()

描述

從 StateRestore 擴充功能中移除已儲存的狀態。

參數
回傳

返回一個 DataTables API 以進行鏈式操作。

範例

移除名為「New State」和「Old State」的狀態

var table = new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: ['createState', 'savedStates']
		}
	}
});

table.stateRestore.states(['New State', 'Old State']).remove();

相關

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