{hero}

stateRestore.state().rename()

自:StateRestore 1.0.0 起

重命名 StateRestore 中的状态。
请注意 - 此属性需要 DataTables 的 StateRestore 扩展。

说明

此方法提供重命名由 StateRestore 扩展管理的状态的能力。

stateRestore.state().rename() 有一个参数,newIdentifier 是选定状态的新标识符。它重命名 stateRestore.state() 之前调用检索到的状态。

返回一个 DataTables API 实例,以便进一步链接。

如果 stateRestoreConfig 配置对象的 rename 选项设置为 false,则此 API 方法不会执行任何操作。

类型

函数 stateRestore.state().rename()

说明

重新命名 StateRestore 扩展的存储状态。

参数
返回

返回一个 DataTables API 用于链接。

示例

重命名一个名为“New State”的状态

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

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

关联

以下选项直接相关,在您的应用程序开发中可能也有用。