button().enable()
起始版本: Buttons 1.0.0
啟用/停用所選按鈕。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。
描述
基於某些外部邏輯來啟用和停用按鈕通常很有用。一個常見的例子是當表格中沒有選取任何列時,編輯按鈕會被停用。
當按鈕被停用時,其視覺外觀會更新以顯示其停用狀態(這是通過將類別 disabled
添加到按鈕元素來完成的)。此外,當點擊停用的按鈕(或通過鍵盤或 button().trigger()
觸發)時,按鈕的動作不會執行。
此方法可用於動態更改所選按鈕的啟用狀態。
類型
function button().enable( [ state ] )
- 描述
設定所選按鈕的啟用狀態。
- 參數
名稱 類型 選填 1 state
是 - 預設值:true 當設定為
false
時,可選參數可用於停用按鈕。這對於在條件運算符上更改按鈕的啟用狀態很有用。- 回傳
DataTables API 實例,其中包含結果集中的所選按鈕,可用於在按鈕上鏈式執行進一步操作。
範例
啟用按鈕索引 0
var table = new DataTable('#myTable');
table.button(0).enable();
根據邏輯條件設定啟用狀態
var table = new DataTable('#myTable');
table
.button('edit:name')
.enable(table.rows({ selected: true }).indexes().length === 0 ? false : true);