{hero}

stateRestore-change

自:StateRestore 1.0.0

當 StateRestore 內的狀態被新增、移除或變更時觸發。
請注意 - 此屬性需要 DataTables 的 StateRestore 擴充功能。

描述

當 StateRestore 內的狀態發生以下其中一種情況時,就會觸發此事件。

  • 新增一個新的狀態
  • 移除一個狀態
  • 重新命名一個狀態。
  • 更新一個狀態

這有幾個用途,但對我們來說主要用途是更新包含目前啟用的狀態的標籤。您可以在 這個範例 中看到它的實際應用。

該事件會在原始的表格元素上觸發。

類型

事件

描述

當 StateRestore 狀態被新增、移除或變更時觸發。

範例

當發生變更時更新活動標籤

table.on('draw stateRestore-change', function () {
	var active = table.stateRestore.activeStates();
	var activeString = 'Active States: ';

	if (active.length > 0) {
		activeString += active[0].name;
		for (var i = 1; i < active.length; i++) {
			activeString += ', ' + active[i].name;
		}
	}
	else {
		activeString += 'No active state';
	}

	$('div.activeStates').text(activeString);
});