buttons().collectionRebuild()

自版本：Buttons 2.0.0 起

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

描述

此函數用於更改或更新集合按鈕的內容。這使得可以輕鬆地將按鈕添加到集合中，而無需重新宣告集合按鈕。

類型

function buttons().collectionRebuild( buttons )

描述

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

參數

返回

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

DataTables.Api

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

範例

將 excel 按鈕新增到集合按鈕

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

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

從集合中移除 csv 按鈕

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

table.buttons([0, 1]).collectionRebuild(['pdf']);

清空集合

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

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