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([]);