stateRestore.state.add()

自：StateRestore 1.0.0 起

建立新的狀態。
請注意 - 此屬性需要 DataTables 的 StateRestore 擴充功能。

說明

此方法提供建立由 StateRestore 擴充功能管理的新狀態的功能。

stateRestore.state.add() 接受一個參數，identifier。此字串用於在整個 StateRestore 中識別狀態。它用於在選定的任何儲存方法中命名狀態，並顯示在狀態的按鈕中。

DataTables API 結果集中傳回的物件，表示儲存時表格中存在的狀態。

類型

function stateRestore.state.add()

說明

建立新的 StateRestore 實例。

參數

傳回

	名稱	類型	可選
1	`identifier`	`字串`	否
	用於識別此狀態的字串。為了區分 StateRestore 中可能儲存的不同狀態，此字串必須是唯一的。

DataTablesApi

傳回用於鏈接的 DataTables API，其結果集中包含從表格中提取的狀態的物件。

範例

新增一個名為「新狀態」的新狀態

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

table.stateRestore.state.add('New State');