buttons().action()
始於:Buttons 1.0.0
取得 / 設定所選按鈕的動作函式。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。
說明
此方法提供了取得或設定所選按鈕的動作函式的功能。 動作函式 (可透過 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();
});