{hero}

rowGroup.startRender

自:RowGroup 1.0.0 起

提供一个函数,用于控制分组起始行中显示的数据。
请注意 - 此属性需要 DataTables 的 RowGroup 扩展。

描述

修改 RowGroup 显示的分组行内容可能非常有用。默认情况下,它只会显示分组数据值,但通常您可能希望显示更复杂的数据,如聚合、计数和其他摘要信息。此选项通过允许您指定一个函数来返回组起始行中显示的数据,从而提供该功能。

此选项定义的函数将针对 DataTables 当前页面中显示的每个组调用一次,并将每次更改页面时(如分页、搜索或排序)再次调用,以保持分组信息最新。因此,所使用的函数其执行速度应该相对较快 - 例如,不要进行任何异步 Ajax 调用!

类型

null

描述

如果给定为 null,则分组起始行不会显示在表格中。

function startRender( rows, group, level )

参数
返回

渲染函数返回的信息可能是

  • 字符串:在这种情况下,RowGroup 将为分组行创建 trtd 元素,其中 colspan 值使单个单元格跨越表格的宽度。
  • tr 节点:其中包含一个行,该行将作为组起始行注入到表格中。如果您希望在分组行中使用多个单元格,这是很有用的 - 例如,与主机数据对齐。
  • 包含 tr 节点的 jQuery 对象。它与 tr 元素完全相同,并提供了便利性。

默认

  • 值:function (rows, data) { return data; }

默认函数仅显示分组数据点的值。

示例

显示组内的行数以及组数据值

new DataTable('#myTable', {
	rowGroup: {
		startRender: function (rows, group) {
			return group + ' (' + rows.count() + ' rows)';
		}
	}
});