{hero}

rowGroup().dataSrc()

自:RowGroup 1.0.0

获取/设置行分组的数据源。
请注意 - 此属性需要 DataTables 的 RowGroup 扩展功能。

描述

RowGroup 需要知道数据源对象或阵列中的哪个数据点用作分组参数(例如,所有Location 为“Edinburgh”的行应分组在一起),而 rowGroup.dataSrc 属性在表初始化时提供该能力。此方法提供在运行时更改数据源的能力。

请注意,不需要在 DataTable 中将数据源属性用作一个列 - 尤其当对象用作数据源时,然而,有时将数据放入一个列中以便按该数据点排序非常有用。

当此方法用作赋值器时,它将触发 rowgroup-datasrc 事件,允许监听器基于新的分组数据源修改 DataTable 设置。

请注意,在 DataTable 重新绘制之前,分组数据点更改的视觉效果不会显示。通常通过调用 draw() 方法完成此操作。

类型

function rowGroup().dataSrc()

描述

获取当前用作分组数据源的属性。

返回

数据源属性

function rowGroup().dataSrc( prop )

描述

设置用作分组数据源的属性。

从 RowGroup 1.1.0 开始,此值可以设置为阵列,从而允许多级行分组。

参数
返回

DataTables API 实例

示例

根据数据点更改数据源,允许最终用户轻松更改分组方式

var table = new DataTable('#myTable', {
	orderFixed: [[2, 'asc']],
	rowGroup: {
		dataSrc: 2
	}
});

// Change the fixed ordering when the data source is updated
table.on('rowgroup-datasrc', function (e, dt, val) {
	table.order.fixed({ pre: [[val, 'asc']] }).draw();
});

$('a.group-by').on('click', function (e) {
	e.preventDefault();

	table.rowGroup().dataSrc($(this).data('column'));
});

相关

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