button()

自：Buttons 1.0.0 起

選取單一按鈕。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

如同核心 DataTables API，Buttons 提供複數/單數 API，可以在單一或多個按鈕上執行操作。雖然在 Buttons 中，您通常會使用此方法處理單一按鈕，但 buttons() 在某些操作中也很有用。

Buttons 擴充功能提供了一組強大的選擇器選項，讓您可以選擇要對哪些按鈕執行動作。這與核心 DataTables 的 row()、column() 和 cell() 非常相似，它們提供了從表格中選擇元素的能力，更一般來說，也像 jQuery 選擇器一樣，因此您會立即熟悉這個介面。

使用 button-selector 參數，您可以選擇要執行操作的按鈕（例如變更顯示文字或啟用和停用按鈕）。

此外，由於可以將 Buttons 擴充功能的多個實例附加到單一 DataTable，因此可以選擇性地包含 button-group-selector 選項，以從特定按鈕集合中選擇按鈕，或搜尋多個集合。

重要事項：如果使用的選擇器導致選取多個按鈕，則此方法會自動將結果截斷為僅找到的第一個按鈕。

描述

從附加到 DataTable 的按鈕實例中選取單一按鈕。

參數

	名稱	類型	可選
1	`groupSelector`	`button-group-selector`	是
	按鈕群組（實例）選擇器。提供從 Buttons 類別的特定實例中選取按鈕的功能。預設情況下，這是 `undefined`，導致選取附加到 DataTable 的所有實例。
2	`buttonSelector`	`button-selector`	否
	用於取得應執行動作之按鈕的選擇器。

返回

DataTables.Api

DataTables API 實例，其中結果集包含有關選定按鈕的資訊，以便可以鏈接操作。

停用索引位置 2 的按鈕

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

table.button(2).disable();

變更索引為 3-1 的集合按鈕的文字

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

table.button('3-1').text('Not available');

從按鈕實例索引 0 中選取並停用按鈕索引 1

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

table.buttons(0, 1).disable();

啟用實例索引 1 中名為 csv 的按鈕

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

table.buttons(1, 'csv:name').enable();