集合

自：Buttons 1.0.0

触发包含另一组按钮的下拉列表的按钮。
请注意 - 此属性需要 DataTables 的按钮扩展。

说明

集合按钮类型对于 Buttons 至关重要，因为它提供了在按钮激活时显示的下拉列表中显示一个或多个“子按钮”的功能。这为收集类似按钮并以对最终用户有效率的方式显示它们提供了一种方法。

此按钮类型的主要方面是buttons选项，它是一个按钮数组，您希望在下拉列表中显示这些按钮。在此定义的按钮与任何其他按钮完全相同，还可以通过 API 访问并以这种方式进行操作。

选项

除了所有按钮都可用的那些选项（例如 buttons.buttons.text）之外，此按钮可以在其配置对象中设置以下选项以自定义其操作和显示

名称	类型	默认
`action`
显示集合
`align` 自：1.6.0		dt-container
相对于按钮的弹出窗口的水平对齐方式。它可能是以下之一 `button-left` - 对齐到激活按钮的左边。 `button-right` - 对齐到激活按钮的右边。 `container` - 对齐到 DataTables 的容器的左边和右边（自 2.2.2）。 `dt-container` - 对齐到 DataTables 的容器的左边并横跨其整个宽度 - 已弃用，请使用 `container` 和 `span` 选项。
`autoClose` 自：1.1.2		false
当集合中的按钮被激活时自动关闭集合。
`background`		true
显示 (`true`) 背景元素，可以在通过 CSS 设置样式，通过使页面的其他部分淡出以突出显示集合，或不显示（`false`）。
`backgroundClassName`		dt-button-background
如果启用，则添加到背景元素的类名称。
`buttons`		[]
显示在集合中的按钮。此数组中的元素遵循与`buttons.buttons`数组相同的规则 - 也就是说。它可以包含字符串、对象和描述按钮的函数。从 Buttons 1.1 开始，这也包括触发其他集合显示的按钮（即嵌套集合）。
`className`		buttons-collection
按钮的类名称。详情请见`buttons.buttons.className`。
`collectionLayout`
集合中显示的按钮的布局选项。这是一个字符串，可以有位置 `dropdown` - 从主机按钮下拉集合 `fixed` - 在窗口上居中显示集合列布局 `columns` - 自动列显示（基于屏幕大小），最多四列 `两列` - 在两列中显示 `三列` - 在三列中显示 `四列` - 在四列中显示列布局可以使用下拉菜单的默认绝对定位，或者使用固定定位布局选项。要使用固定定位和多列布局，只需用空格分隔选项 - 例如 `固定列`。
`collectionTitle` 自：1.5.4
赞成 popoverTitle 已弃用 - 将删除版本 3.0.0 在集合顶部显示的文本字符串。对于多级集合，这很有用，以确保最终用户知道当前菜单指的是什么。
`dropup`		false
当为 `true` 时，下拉集合始终向上翻转。当为 `false` 时，集合会根据可用的溢出内容向下或向上翻转。
`fade`		400
集合淡入淡出显示的动画速度。这是一个整数值，表示动画持续时间（毫秒）。不使用动画，请使用值 `0`。
`popoverTitle` 自：2.0.0
在集合顶部显示的文本字符串。对于多级集合，这很有用，以确保最终用户知道当前菜单指的是什么。
`postfixButtons`		undefined
应该后缀到现有集合的按钮列表（参见 `buttons` 选项）。这为扩展集合的按钮提供了将项目添加到集合子按钮末尾的功能。与 `buttons` 选项一样，此数组中的元素遵循与 `buttons.buttons` 数组相同的规则。
`prefixButtons`		undefined
应该前缀到现有集合的按钮列表（参见 `buttons` 选项）。这为扩展集合的按钮提供了将项目添加到集合子按钮开始位置的功能。与 `buttons` 选项一样，此数组中的元素遵循与 `buttons.buttons` 数组相同的规则。
`span` 自：2.2.2		container
将下拉菜单的宽度与数据表格容器匹配。 `default` - 集合下拉菜单的宽度由 CSS 定义。 `container` - 跨越整个 DataTables 容器的宽度（适用于大型内容区域）。
`text`		集合
按钮的显示文本。可以使用此选项配置文本（参见 `buttons.buttons.text`）或 DataTables `language` 对象的 `buttons.print` 选项。

示例

DataTables 初始化：创建导出集合

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'collection',
					text: 'Export',
					buttons: ['csv', 'excel', 'pdf']
				}
			]
		}
	}
});