searchPanes.threshold

设置显示一个列的面板所需的最小唯一值比列占总值。
请注意 - 此属性需要 SearchPanes DataTables 的扩展。

说明

正常情况下，SearchPanes 将自动确定哪些列应该用于过滤。它通过计算列中的唯一值与同一列中的值的总数来实现这一点。然后该比率将与 searchPanes.threshold 的值进行比较。如果比率小于或等于此值，那么面板将显示给用户。

考虑一个有 4 行 4 列的表格。对于列 1，每一行具有不同的唯一值。这将为我们的比率提供 1 的值，因此不会为此列显示面板。

列 2 在第 1 行和第 2 行有一个唯一值，并且在第 3 行和第 4 行有不同的唯一值。我们这列的比率便是 0.5（2 个不同值比 4 个总值），并且该面板将显示。

列 3 在第 1 行和第 2 行有一个唯一值，在第 3 行和第 4 行中有 2 个不同唯一值。我们这列的比率是 0.75（3 个不同值比 4 个总值），并且该面板将不显示。

列 4 具有一个唯一值，它在所有行中相同。此面板不会受阈值检查，因为整个列中只有一个唯一值 - 按其过滤没有任何意义。

事实上，随着比率的值朝着 1 上升，该列中的数据越“唯一”。

此系统也可以应用于具有数组的列。由于计算选项的总数，而不仅仅是使用行数，因此仍然可以执行准确的计算。假设您有一个使用 2 行数组的列。第 1 行包含 4 个不同值，第 2 行包含 4 个值，其中 2 个与第 1 行共享，其余 2 个与该集合不同。这意味着该列中有 6 个不同的选项，跨越 8 个显示的值，比率为 0.75 (6/8)。

因此，通过将 searchPanes.threshold 选项设置为不同的十进制值，可以改变显示面板的点。这对于保持简洁的用户界面并仅显示可能提供“有用”过滤的面板非常有用。

也可以通过使用 columns.searchPanes.threshold 选项为各个列设置唯一性比率的阈值。

如果您希望强制某些窗格始终显示，或始终隐藏，请使用columns.searchPanes.show选项。这是一个强制窗格显示/隐藏的更简洁的方式。

类型

默认值

• 值：0.6

searchPanes.threshold参数的默认值为0.6。

示例

new DataTable('#myTable', {
	layout: {
		top1: {
			searchPanes: {
				threshold: 0.4
			}
		}
	}
});

相关信息

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