{hero}

searchPanes.panes.options.value

自:SearchPanes 1.0.0 起

定義自訂窗格選項的值。
請注意 - 此屬性需要 DataTables 的 SearchPanes 擴充套件。

描述

預設情況下,value 的值是未定義的。

searchPanes.panes.options.value 可以是字串或函式。如果它是字串,則會在其與表格中的資料之間執行直接的 === 比較。值得注意的是,對於沒有附加任何欄位的完全自訂窗格來說,情況並非如此,因為 SearchPanes 不知道要與什麼進行比較。在這種情況下,SearchPanes 必須使用函式。

searchPanes.panes.options.value 設定為函式允許 SearchPanes 使用該函式來搜尋 DataTable 中的結果。來自該列的資料和列索引會傳遞到此函式中。上下文是父 DataTable。函式內部取決於您希望建立的行為。從函式傳回 true 會將該列包含在結果中,相反地,false 會排除該列。

value 屬性設為函式意味著可以在各種不同的複雜程度進行比較,所有這些都完全開放給開發人員的需求。

下面的範例顯示了一個非常簡單的函式,該函式會比較多個欄位的資料。

類型

字串

描述

如果 searchPanes.panes.options.value 是字串,則會透過直接與表格中的資料比較來決定是否將列包含在結果中。

函式

描述

如果 searchPanes.panes.options.value 是函式,則將使用此函式來決定是否要包含列。它會傳回一個布林值,表示此資訊。函式的上下文是父表格。也會提供該列的資料,以便函式能夠做出明智的決策。

參數
傳回

布林值,表示是否應將列包含在結果中。

預設

  • 值:Undefined

searchPanes.panes.options.value 的預設值是未定義的,因為自訂窗格必須在外部定義。

範例

定義自訂窗格選項

new DataTable('#myTable', {
	layout: {
		top1: {
			searchPanes: {
				panes: [
					{
						options: [
							{
								label: 'Accountants in Tokyo',
								value: function (rowData, rowIdx) {
									return rowData[2] === 'Accountant' && rowData[3] === 'Tokyo';
								}
							}
						]
					}
				]
			}
		}
	}
});

相關

下列選項直接相關,並且也可能在您的應用程式開發中有所幫助。