按钮操作
自:按钮 1.1.2
按钮操作方法已触发。
请注意 - 此特性需要适用于 DataTables 的 按钮 扩展。
描述
每当按钮的 action
方法由最终用户(通过键盘、鼠标或触控)或由 API(button().trigger()
)触发时,此事件都会触发。它通过传递给它的参数提供有关触发按钮的信息。
请注意,该事件会在操作事件之后触发。不可通过该事件修改操作。
请注意,与所有 DataTables 发出的事件一样,此事件也会使用 dt
命名空间触发。因此,如果你使用 jQuery 直接监听此事件,则还必须使用 dt
命名空间,只需将 .dt
附加到你的事件名称即可。如果你使用 DataTables on()
方法,则会自动执行此操作。
类型
函数 function( e, buttonApi, dataTable, node, config )
- 参数
名称 类型 可选 1 e
否 jQuery 事件对象
2 buttonApi
否 被选按钮的 DataTables API 实例 - 即
button()
,针对有问题的按钮3 dt
否 主机 DataTable 的 DataTables API 实例
4 node
否 被点击的按钮节点的 jQuery 实例
5 config
否 按钮的配置对象
示例
显示激活按钮的名称消息
var table = new DataTable('#myTable');
table.on('buttons-action', function (e, buttonApi, dataTable, node, config) {
console.log('Button ' + buttonApi.text() + ' was activated');
});