stateRestore.state.add()

自：StateRestore 1.0.0

创建新状态。
请注意 - 该属性需要 DataTables 的 StateRestore 扩展。

说明

此方法提供了创建由 StateRestore 扩展管理的新状态的能力。

stateRestore.state.add() 接收一个参数，identifier。该字符串用于在 StateRestore 中识别状态。在以任何选中的存储方法命名状态以及在状态的按钮中显示该方法时使用它。

DataTables API 结果集中返回的对象表示保存时的表中存在的状态。

类型

function stateRestore.state.add()

说明

创建新的 StateRestore 实例。

参数

返回值

	名称	类型	可选
1	`identifier`	`string`	否
	用于识别此状态的字符串。该字符串必须是唯一的，以便区分可能存储在 StateRestore 中的不同状态。

DataTablesApi

返回用于链接的 DataTables API，结果集中包含从表中提取的状态的对象。

示例

添加名为“New State”的新状态

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

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