{hero}

searchPanes.panes.options.value

自:SearchPanes 1.0.0 起

定义自定义窗格选项的值。
请注意 - 此属性需要 SearchPanes 扩展才能用于 DataTables。

说明

通常情况下,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 是一个函数,则该函数将用于决定是否包含某行。它返回一个布尔值来指示这一点。该函数的上下文是父表格。还提供了该行的数据,以便该函数能够做出明智的决策。

参数
返回

布尔值,指示是否应该将该行包含在结果中。

默认值

  • 值:未定义

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';
								}
							}
						]
					}
				]
			}
		}
	}
});

相关

以下选项直接相关,在你的应用程序开发中也可能有用。