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 实例，其中的结果集包含有关所选按钮的信息，以便可以链接操作。

禁用所有 class 为 '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 的实例中启用所有 class 为 export 的按钮

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

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