columns.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，这将是所有列的默认值，除非另外由 searchPanes.thresold 指定。

范例

new DataTable('#myTable', {
	layout: {
		top1: 'searchPanes'
	},
	columnDefs: [
		{
			searchPanes: {
				threshold: 0.99
			},
			targets: [0]
		}
	]
});

相关

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