searchPanes.panes.options.value
定義自訂窗格選項的值。
請注意 - 此屬性需要 DataTables 的 SearchPanes 擴充套件。
描述
預設情況下,value
的值是未定義的。
searchPanes.panes.options.value
可以是字串或函式。如果它是字串,則會在其與表格中的資料之間執行直接的 ===
比較。值得注意的是,對於沒有附加任何欄位的完全自訂窗格來說,情況並非如此,因為 SearchPanes 不知道要與什麼進行比較。在這種情況下,SearchPanes 必須使用函式。
將 searchPanes.panes.options.value
設定為函式允許 SearchPanes 使用該函式來搜尋 DataTable 中的結果。來自該列的資料和列索引會傳遞到此函式中。上下文是父 DataTable。函式內部取決於您希望建立的行為。從函式傳回 true
會將該列包含在結果中,相反地,false
會排除該列。
將 value
屬性設為函式意味著可以在各種不同的複雜程度進行比較,所有這些都完全開放給開發人員的需求。
下面的範例顯示了一個非常簡單的函式,該函式會比較多個欄位的資料。
類型
函式
- 描述
如果
searchPanes.panes.options.value
是函式,則將使用此函式來決定是否要包含列。它會傳回一個布林值,表示此資訊。函式的上下文是父表格。也會提供該列的資料,以便函式能夠做出明智的決策。- 參數
名稱 類型 選填 1 rowData
否 正在比較的列的資料。
2 rowIdx
否 正在比較的列在 DataTable 中的索引。
- 傳回
布林值,表示是否應將列包含在結果中。
預設
- 值:
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';
}
}
]
}
]
}
}
}
});
相關
下列選項直接相關,並且也可能在您的應用程式開發中有所幫助。