重命名状态

重命名状态。
请注意 - 此属性需要 StateRestore 扩展才能适用于 DataTables。

说明

这用作 stateRestore 中的二级按钮之一，它表示并提供已保存状态的功能。此按钮将重命名相关状态。这将更改此状态下按钮中显示的文本值，以及使用 API 方法时引用该状态所用的值。

拆分按钮中还有另外 2 个二级按钮 - removeState 和 updateState。它们各自的文档提供了与其功能相关的更多详细信息。

此按钮在 StateRestore 扩展中使用。如果使用父按钮的 stateRestoreConfig 配置对象的 renameSate 选项禁用了重命名，则此按钮不会执行任何操作。

此按钮没有其他可用配置选项，仅提供按钮的所有标准选项（例如 text）。使用 language.buttons.renameState 选项可以在按钮中设置文本。

示例

DataTable.ext.buttons.renameState.text = function (e, dt, node, config) {
	return 'Rename State';
};