{hero}

重新命名狀態

起始版本:StateRestore 1.0.0

重新命名狀態。
請注意 - 此屬性需要 DataTables 的 StateRestore 擴充套件。

說明

這用作 stateRestore 分割按鈕中的其中一個次要按鈕,該按鈕表示並提供已儲存狀態的功能。此按鈕重新命名相關狀態。這會變更此狀態的按鈕中顯示的文字值,以及使用 API 方法時將用於參考它的值。

分割按鈕中還有另外 2 個次要按鈕 - removeStateupdateState。它們的文件提供了與其功能相關的更多詳細資訊。

此按鈕在 StateRestore 擴充套件中使用。如果使用父按鈕的 stateRestoreConfig 組態物件的 renameSate 選項停用重新命名,它將不會執行任何操作。

除了所有按鈕提供的標準設定(例如 text)之外,此按鈕沒有任何其他可用的組態選項。可以使用 language.buttons.renameState 選項設定按鈕中的文字。

範例

重新命名狀態按鈕修改文字

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