rowGroup.startRender
自:RowGroup 1.0.0 起
提供一個函式,可用於控制起始分組列中顯示的資料。
請注意 - 此屬性需要 DataTables 的 RowGroup 擴充功能。
描述
修改 RowGroup 顯示的分組列內容會非常有用。預設情況下,它只會顯示分組資料值,但通常您可能希望顯示更複雜的資料,例如彙總、計數和其他摘要資訊。此選項提供此功能,讓您可以指定一個函式,該函式會傳回要在群組起始列中顯示的資料。
此選項定義的函式將針對 DataTables 目前頁面中顯示的每個群組呼叫一次,並且每次頁面變更時(例如分頁、搜尋或排序)都會再次呼叫,以保持分組資訊的最新狀態。因此,重要的是所使用的函式執行速度要相對快 - 例如,不要進行任何非同步 Ajax 呼叫!
類型
function startRender( rows, group, level )
- 參數
名稱 類型 選填 1 rows
否 一個 DataTables API 實例,由
rows()
針對此群組中顯示在目前頁面上的列產生。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)';
}
}
});