stateSaveParams

说明

该stateSaveParams事件是stateSaveParams初始化选项的事件补语。与回调一样，当表格的状态发生变化时就会触发该事件，且需要保存新的状态。有关存储的数据格式，请参阅stateSaveCallback文档。

该事件允许在实际保存之前先修改状态保存对象，包括添加其他状态属性（供插件使用）或修改 DataTables 核心属性。

该stateSaveParams事件会在与stateSaveCallback相同的时间点触发（从技术上讲，该回调在该事件之前触发，但它们按顺序触发，因此都可以实现相同的效果）。

请注意，与所有 DataTables 发出的事件一样，该事件对象都有一个 DataTables API 实例（第一个参数）可用。此外，这些事件使用dt命名空间触发。因此，要侦听此事件，您还必须使用dt命名空间，方法是在您的事件名称后面简单添加.dt，如下面示例所示。

注意：从 1.11.0 开始，无论stateSave选项如何，都会触发此事件。这允许始终跟踪最新状态并向用户提供该状态。

类型

函数函数 (e, settings, data)

删除保存的筛选器，这样就永远不会保存筛选器

$('#example')
	.on('stateSaveParams.dt', function (e, settings, data) {
		data.search.search = '';
	})
	.DataTable();

相关

以下选项直接相关，并且在应用程序开发中可能也有用。