rowGroup.startRender
自:RowGroup 1.0.0 起
提供一个函数,用于控制分组起始行中显示的数据。
请注意 - 此属性需要 DataTables 的 RowGroup 扩展。
描述
修改 RowGroup 显示的分组行内容可能非常有用。默认情况下,它只会显示分组数据值,但通常您可能希望显示更复杂的数据,如聚合、计数和其他摘要信息。此选项通过允许您指定一个函数来返回组起始行中显示的数据,从而提供该功能。
此选项定义的函数将针对 DataTables 当前页面中显示的每个组调用一次,并将每次更改页面时(如分页、搜索或排序)再次调用,以保持分组信息最新。因此,所使用的函数其执行速度应该相对较快 - 例如,不要进行任何异步 Ajax 调用!
类型
function startRender( rows, group, level )
- 参数
名称 类型 可选 1 rows
否 此组中行上
rows()
生成的 DataTables API 实例,显示在当前页面上。2 group
否 组数据点的值(由
rowGroup.dataSrc
定义)。3 level
否 自 1.1.0 起:嵌套级别。顶级为索引 0。
- 返回
渲染函数返回的信息可能是
- 字符串:在这种情况下,RowGroup 将为分组行创建
tr
和td
元素,其中colspan
值使单个单元格跨越表格的宽度。 tr
节点:其中包含一个行,该行将作为组起始行注入到表格中。如果您希望在分组行中使用多个单元格,这是很有用的 - 例如,与主机数据对齐。- 包含
tr
节点的 jQuery 对象。它与tr
元素完全相同,并提供了便利性。
- 字符串:在这种情况下,RowGroup 将为分组行创建
默认
- 值:
function (rows, data) { return data; }
默认函数仅显示分组数据点的值。
示例
显示组内的行数以及组数据值
new DataTable('#myTable', {
rowGroup: {
startRender: function (rows, group) {
return group + ' (' + rows.count() + ' rows)';
}
}
});