按钮.按钮

自：按钮 3.0.0

要创建的按钮列表。
请注意 - 此属性需要 DataTables 的Buttons扩展。

说明

buttons.buttons数组定义了在文档中显示给最终用户的按钮。数组中的每个元素可以是以下之一

string - 内置按钮类型或插件按钮类型的名称。这相当于使用{ extend: ... }。
object - 自定义按钮或现有按钮类型的自定义。可以定义extend属性（参见buttons.buttons.extend），以告诉 Buttons 要以哪种按钮类型为基础，以及你要自定义的任何配置选项。或者，如果未给出extend选项，请使用text和action选项来定义按钮。Buttons 仅为每个按钮提供了少数内置配置选项，但各种按钮类型可能提供了附加选项。请参阅每个按钮类型的文档以获取有关它们提供的更多选项的信息。内置选项是
- buttons.buttons.action - 描述激活后要执行的操作的函数
- buttons.buttons.className - 按钮类名称
- buttons.buttons.enabled - 初始启用状态
- buttons.buttons.extend - 基于扩展对象
- buttons.buttons.init - 按钮初始化回调函数
- buttons.buttons.key - 键激活配置
- buttons.buttons.name - 在选择器中使用的按钮名称
- buttons.buttons.text - 可见文本
function - 在创建按钮时将执行的函数。该函数仅传递单个参数，即主机 DataTable 的 DataTables API 实例，并且结果值应与上述选项或上述选项的数组相匹配。

类型

数组

说明: 此数组定义了显示在按钮集合中的按钮列表。数组中的每个元素可以采用许多选项，包括字符串、对象和函数。有关完整详细信息，请参阅上面的文档。数组可以包含每种类型的多个元素。

示例

buttons 作为使用基本类型的数组

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: ['copy', 'csv', 'print']
		}
	}
});

两个按钮，一个带有自定义功能

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: {
				buttons: ['copy', { extend: 'excel', text: 'Save as Excel' }]
			}
		}
	}
});

一个完全自定义的按钮

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: {
				buttons: [
					'copy',
					{
						text: 'My button',
						action: function (dt) {
							console.log('My custom button!');
						}
					}
				]
			}
		}
	}
});

实例初始化：使用按钮数组

new DataTable.Buttons(table, {
	buttons: ['copy', { extend: 'excel', text: 'Save as Excel' }]
});