button().add()

自：Buttons 1.0.0

创建一个新按钮并将其添加到文档中。
请注意 - 此属性需要 DataTables 的按钮扩展。

描述

此方法提供动态向按钮实例添加新按钮的功能。此方法的逆方法是 button().remove()，它可用于动态删除现有按钮。

重要：此方法将影响实例中其他按钮的索引。如果您正在使用基于索引的选择器来选择按钮，请确保在调用此方法后，在 API 交互中考虑到这一点。

当使用 buttons() 选择器方法时，在处理此方法时，第二个参数（按钮选择器）实际上会被忽略。仅使用按钮实例。

类型

function button().add( index, config, draw )

描述

创建一个新按钮，将其添加到选定的按钮实例中，并立即插入到文档中。

参数

	名称	类型	可选
1	`index`	`int`，`string`，`null`	否
	按钮的插入索引。此选项可以是以下之一如果要将值插入到主按钮集合中，则为一个整数值，如果要将按钮插入到集合中，则为带破折号（`-`）分隔符的字符串（请参阅 `button-selector` 文档以了解按钮索引的完整详细信息，包括它们如何应用于子按钮集合）， `null` 以将按钮插入到主按钮集合的末尾。
2	`config`	`object`，`string`，`function`	否
	按钮配置。有关此处可用配置选项的完整详细信息，请参阅 `buttons.buttons`。
3	`draw`	`boolean`	是 - 默认值：true
	自 2.1.0 起：指示 Buttons 是否应该立即绘制新按钮 (`true`) 还是不绘制 (`false`)。当添加大量按钮时，这可能很有用，因为在添加最后一个项目之前禁用绘制可以显着提高性能。

返回

DataTables.Api

新的 DataTables API 实例，其结果集包含新创建的按钮。这意味着可以立即使用链式 API 来操作按钮。

示例

添加一个新按钮，插入到索引位置 0，提供重新加载 Ajax 来源 DataTables 的功能

var table = new DataTable('#myTable');

table.button().add(0, {
	action: function (e, dt, button, config) {
		dt.ajax.reload();
	},
	text: 'Reload table'
});