{hero}

searchPanes.cascadePanes

自:SearchPanes 1.0.0

通过选择让面板级联。
请注意 - 此属性需要适用于 DataTables 的 SearchPanes 扩展。

说明符

按照标准,SearchPanes 将在操作期间显示该列的所有选项。当 searchPanes.cascadePanes 被设为 true,面板将移除当前显示的 DataTable 中不再存在的选项。当某一面板中进行选择或取消选择时,会发生级联操作。

当处理拥有许多不同选项的大型数据集时,随着选择的不断进行,选项也会相应减少,此时该功能就很有用。

注意:在配合使用 columns.searchPanes.combinersearchPanes.cascadePanes 时,必须确保您的数据适合您进行的选择。开发 searchPanes.cascadePanes 时考虑的默认逻辑是 or,大多数情况下使用 and 逻辑都能正常运行,但在极少情况下取消选择时可能会产生一些意外结果。

注意:通过 ajax 加载 SearchPanes 选项,但随后未使用 serverSide 处理时,既不支持 searchPanes.cascadePanes,也不支持 searchPanes.viewTotal。这是因为要求用户为 SearchPanes 选项,在使用这两个选项时其值会发生改变,提供准确的数据。虽然仍然可以启用这些选项,但建议不要启用,可能会导致出现意外行为。

类型

布尔值

说明符

searchPanes.cascadePanes 选项设为 true 时,当进行选择时,其他面板中表的当前显示值不存在的选项将被隐藏。

默认

  • 值:false

对于 searchPanes.cascadePanes 参数的默认值为 false。当此默认值就绪时,将不会采取任何措施来级联面板。

示例

启用级联面板:

new DataTable('#myTable', {
	layout: {
		top1: {
			searchPanes: {
				cascadePanes: true
			}
		}
	}
});