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