columns.searchPanes.threshold

設定特定欄位中顯示窗格所需的唯一值最小數量。
請注意 - 此屬性需要 DataTables 的 SearchPanes 擴充套件。

描述

依照標準，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]
		}
	]
});

相關

以下選項直接相關，並且在您的應用程式開發中也可能很有用。