buttons().action()
自:Buttons 1.0.0
获取/设置所选按钮的操作函数。
请注意 - 此属性需要 DataTables 的 按钮 扩展。
描述
此方法提供获取或设置所选按钮操作函数的能力。 操作函数(可以通过 buttons.buttons.action
在初始化时设置)定义按钮激活时将执行的操作。
请注意,当设置操作时,新函数将替换按钮已经分配的任何操作。 这是一个重要的考虑因素,因为许多按钮类型定义了自己的操作,如果被替换将不再执行。
类型
function buttons().action( set )
- 描述
设置所选按钮的操作函数。
- 参数
名称 类型 可选 1 set
否 用于设置所选按钮操作方法的函数,替换之前分配给按钮的任何操作。 所有选定按钮都使用同一个函数。
该函数接受四个参数
object
触发事件的事件对象DataTables.Api
宿主 DataTable 的 DataTables API 实例jQuery
被点击的按钮节点的 jQuery 实例object
按钮的配置对象
不需要返回值。
该函数在所选按钮的 DataTables API 实例(即
button()
)的范围内执行,用于处理该按钮。- 返回值
DataTables API 实例,其中结果集中包含所选按钮,可用于对按钮进一步操作。
示例
为所有按钮设置简单的操作函数
var table = new DataTable('#myTable');
table.buttons().action(function (e, dt, button, config) {
console.log('Button ' + this.text() + ' activated');
this.disable();
});