buttons()

自：Buttons 1.0.0 起

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

說明

Buttons 擴充功能提供了一組強大的選取器選項，讓您可以選取要執行動作的按鈕。這與核心 DataTables 的 rows()、columns() 和 cells() 非常相似，它們提供了從表格中選取元素的功能，而且更一般地來說就像 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 實例，其中結果集包含有關所選按鈕的資訊，以便可以鏈式操作。

停用所有類別為 'csv' 的按鈕

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

table.buttons('.csv').disable();

變更按鈕索引 2 和 2-0 的文字

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

table.buttons([2, '2-0']).text('Not available');

從實例索引 0 選取並停用所有按鈕

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

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

從名稱為 output 的實例啟用所有類別為 export 的按鈕

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

table.buttons('output:name', '.export').enable();