stateRestore-change

Triggered when a state within StateRestore has been added, removed or changed.
Please note - this property requires the StateRestore extension for DataTables.

Description

This event is triggered whenever one of the following occurs to a state within StateRestore.

• A new state is added
• A state is removed
• A state is renamed.
• A state is updated

This has several uses, but the main one for us is to update labels that include which state is currently active. You can see this in action in this example.

The event is triggered on the original table element.

Type

Example

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);
});