{hero}

rowGroup().dataSrc()

起始版本:RowGroup 1.0.0

取得/設定列分組的資料來源。
請注意 - 此屬性需要 DataTables 的 RowGroup 擴充功能。

描述

RowGroup 需要知道您資料來源物件或陣列中的哪個資料點要用作分組參數(例如,所有 Location 為「Edinburgh」的列都應分組在一起),並且在初始化表格時,rowGroup.dataSrc 屬性提供了該功能。此方法提供了在執行時變更資料來源的功能。

請注意,資料來源屬性不需要在 DataTable 中用作欄位 – 特別是當使用物件作為資料來源時,但是,有時將資料放在欄位中以允許按該資料點排序可能會很有用。

當此方法用作設定器時,它將觸發 rowgroup-datasrc 事件,允許監聽器根據新的分組資料來源修改 DataTable 設定。

請注意,變更分組資料點的視覺效果只有在重新繪製 DataTable 時才會顯示。這通常是透過呼叫 draw() 方法來完成。

類型

function rowGroup().dataSrc()

描述

取得目前用作分組資料來源的屬性。

回傳

資料來源屬性

function rowGroup().dataSrc( prop )

描述

設定要用作分組資料來源的屬性。

自 RowGroup 1.1.0 起,可以將此值設定為陣列,以允許多個層級的列分組。

參數
回傳

DataTables API 實例

範例

根據資料點變更資料來源,允許終端使用者輕鬆變更分組方式

var table = new DataTable('#myTable', {
	orderFixed: [[2, 'asc']],
	rowGroup: {
		dataSrc: 2
	}
});

// Change the fixed ordering when the data source is updated
table.on('rowgroup-datasrc', function (e, dt, val) {
	table.order.fixed({ pre: [[val, 'asc']] }).draw();
});

$('a.group-by').on('click', function (e) {
	e.preventDefault();

	table.rowGroup().dataSrc($(this).data('column'));
});

相關

以下選項直接相關,在您的應用程式開發中也可能很有用。