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();