按鈕動作

自：按鈕 1.1.2 起

按鈕的動作方法已被觸發。
請注意 - 此屬性需要 DataTables 的按鈕擴充功能。

描述

當終端使用者（透過鍵盤、滑鼠或觸控）或透過 API (button().trigger()) 觸發按鈕的 action 方法時，就會觸發此事件。它會透過傳遞給它的參數提供有關被觸發按鈕的資訊。

請注意，此事件是在動作事件之後觸發的。無法透過此事件修改動作。

請注意，與所有 DataTables 發出的事件一樣，此事件會使用 dt 命名空間觸發。因此，如果您直接使用 jQuery 來監聽此事件，您還必須使用 dt 命名空間，只需將 .dt 附加到您的事件名稱即可。如果您使用 DataTables on() 方法，則會自動執行此操作。

類型

function function( e, buttonApi, dataTable, node, config )

參數

	名稱	類型	選填
1	`e`	`物件`	否
	jQuery 事件物件
2	`buttonApi`	`DataTables.Api`	否
	所選按鈕的 DataTables API 實例 - 即問題中按鈕的 `button()`
3	`dt`	`DataTables.Api`	否
	主機 DataTable 的 DataTables API 實例
4	`node`	`jQuery`	否
	所點擊按鈕節點的 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');
});