searchPanes.panes.options.value
定义自定义窗格选项的值。
请注意 - 此属性需要 SearchPanes 扩展才能用于 DataTables。
说明
通常情况下,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 中所在位置的索引。
- 返回
布尔值,指示是否应该将该行包含在结果中。
默认值
- 值:
未定义
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';
}
}
]
}
]
}
}
}
});
相关
以下选项直接相关,在你的应用程序开发中也可能有用。