{hero}

searchPanes.preSelect

自:SearchPanes 2.0.0 起

窗格中預先選取的選項。
請注意 - 此屬性需要 DataTables 的 SearchPanes 擴展。

描述

依照標準,SearchPanes 不會預先選取任何窗格中的值。

儲存在此陣列中的物件包含 2 個值。

  • column number - 要進行這些選取的窗格的欄索引。
  • rows string[] - 包含要在對應窗格中選取之列的篩選值的字串陣列。

如果 searchPanes.preSelect.rows 中陣列的任何元素出現在窗格中,則它們將會被預先選取。

此選項取代了已棄用的 columns.searchPanes.preSelect 選項。在這個格式中,現在可以設定選取的順序。這表示 preSelect 現在與 searchPanes.cascadePanes 相容。

若要在自訂窗格中進行預先選取,searchPanes.preSelect.column 值應設定為最後一欄索引與自訂窗格數之總和。例如,如果最後一欄索引為 5,且選取要在第二個自訂窗格中進行,則 searchPanes.preSelect.column 的值應設定為 7

類型

陣列

描述

searchPanes.preSelect 是一個物件陣列,其中包含在對應窗格中預先選取列所需的詳細資訊。

預設

  • 值:[]

searchPanes.preSelect 參數的預設值為 []。當此預設值生效時,將不會預先選取窗格中的任何值。

範例

預先選取窗格中的值

new DataTable('#myTable', {
	layout: {
		top1: {
			searchPanes: {
				preSelect: [
					{
						column: 3,
						rows: ['Edinburgh', 'London']
					}
				]
			}
		}
	}
});