button().collectionRebuild()

自：按鈕 2.0.0 起

重建按鈕集合。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

說明

此函式用於變更或更新集合按鈕的內容。這使得無需重新宣告集合按鈕即可輕鬆地將按鈕新增至集合中。

類型

function button().collectionRebuild( buttons )

說明

根據傳入的陣列重建按鈕集合的內容。

參數

回傳值

	名稱	類型	選填
1	`buttons`	`陣列`	是
	一個包含物件、字串或函式的陣列，用於建立按鈕。有關此處可用的配置選項的完整詳細資訊，請參閱`buttons.buttons`。

DataTables.Api

DataTables API 實例，結果集中包含選定的按鈕，可用於對該按鈕進行進一步的鏈式操作。

範例

將 Excel 按鈕新增至集合

var table = new DataTable('#myTable', {
	buttons: [
		{
			extend: 'collection',
			text: 'print',
			buttons: ['csv', 'pdf']
		}
	]
});

table.button(0).collectionRebuild(['csv', 'pdf', 'excel']);

從集合中移除 CSV 按鈕

var table = new DataTable('#myTable', {
	buttons: [
		{
			extend: 'collection',
			text: 'print',
			buttons: ['csv', 'pdf']
		}
	]
});

table.button(0).collectionRebuild(['pdf']);

清空集合

var table = new DataTable('#myTable', {
	buttons: [
		{
			extend: 'collection',
			text: 'print',
			buttons: ['csv', 'pdf']
		}
	]
});

table.button(0).collectionRebuild([]);