button().collectionRebuild()

自：Buttons 2.0.0

重建一个按钮集。
请注意 - 这个属性需要 Buttons 扩展插件 DataTables。

描述

此函数用于更改或更新一个集合按钮的内容。这使得在无需重新声明集合按钮的情况下轻而易举地把按钮添加到集合中。

类型

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