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。

範例

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

相關

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