button().add()

自版本：Buttons 1.0.0 起

建立一個新按鈕並將其加入文件中。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

此方法提供將新按鈕動態新增至按鈕實例的功能。此方法的相反方法是 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 來源 DataTable 的功能

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

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