{hero}

rowGroup.dataSrc

自版本:RowGroup 1.0.0

設定用作分組資料來源的資料點。
請注意 - 此屬性需要 DataTables 的 RowGroup 擴充功能。

描述

當使用 RowGroup 時,您非常有可能會希望設定此參數,因為它為軟體提供了尋找分組表格中列所需資料的資訊。

請務必注意,如果您使用物件作為表格的資料來源,此屬性應設定為字串(該值為分組資料的屬性名稱),而如果您使用陣列,則應為與分組資料的欄索引相符的索引。

當使用物件時,不一定需要在欄中使用用於分組的資料(除非您也希望能夠按該資料排序表格)。

分組的資料來源可以使用 rowGroup().dataSrc() 方法在表格初始化後動態更改。

類型

數字|字串

描述

如果您的表格使用基於陣列的資料,則應為包含您要用於分組表格的資料的欄索引。對於基於物件的資料來源,它應該是資料來源物件中的屬性名稱。

陣列

描述

從 RowGroup 1.1.0 開始,可以透過將此參數提供為值陣列來巢狀多個資料層級。這些值可以是數字或字串,如上所述。頂層巢狀結構為陣列索引 0,並隨著陣列索引的增加而逐漸加深。

函式 dataSrc( rowData, level )

描述

作為一個函式,此選項提供了使用每列資料自訂分組邏輯的能力。該函式會依序針對表格中顯示的列呼叫。

參數
回傳值

此列應歸入的分組名稱。

預設值

  • 值:0

範例

設定物件屬性名稱作為分組資訊的資料來源

new DataTable('#myTable', {
	rowGroup: {
		dataSrc: 'group'
	}
});

巢狀資料

new DataTable('#myTable', {
	rowGroup: {
		dataSrc: ['group', 'date']
	}
});