stateRestore.state().rename()

從 StateRestore 重新命名一個狀態。
請注意 - 此屬性需要 DataTables 的 StateRestore 擴充功能。

說明

此方法提供重新命名由 StateRestore 擴充功能管理的狀態之功能。

stateRestore.state().rename() 接收一個引數 newIdentifier，它是所選狀態的新識別符。它會重新命名先前呼叫 stateRestore.state() 所擷取的狀態。

會傳回一個 DataTables API 實例，以便進行進一步的鏈式操作。

如果 stateRestoreConfig 設定物件的 rename 選項設為 false，則此 API 方法不會執行任何動作。

類型

範例

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

table.stateRestore.state('New State').rename('New Name');

相關

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