buttons.info()
自:Buttons 1.0.0
在模態框中顯示和隱藏給終端使用者的資訊。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充套件。
描述
當使用 Buttons 時,您可能會希望向終端使用者表明在點擊按鈕時已執行某項操作。這可能是一個簡單的資訊訊息,說明基於按鈕動作發生了什麼,或者可以更複雜,並可能包括複雜的資料輸入/輸出。例如,在複製到剪貼簿按鈕中,它會告知使用者已發生複製 - 否則他們不會知道,因為該動作會在沒有使用者通知的情況下發生。
此方法提供了一種非常簡單的方式來顯示一個模態框,向終端使用者呈現資訊。
雖然此方法專為與 Buttons 一起使用而設計,但如果您希望向終端使用者顯示訊息,也可以在 Buttons 動作之外使用此方法。
類型
function buttons.info( title [, message [, time ]] )
- 描述
顯示/隱藏資訊訊息給終端使用者,以指示發生了某些事情。
- 參數
名稱 類型 可選 1 title
否 訊息標題。這將顯示在
h2
元素中。如果您不希望顯示標題訊息,請將此選項設置為空字串 - 將不會使用h2
元素。此參數也可以用來移除資訊訊息,方法是將
false
傳遞給此參數。2 message
是 要向終端使用者顯示的訊息。這顯示在
div
元素中。3 time
是 設定後,訊息將在此時間後自動移除。時間單位為毫秒。
如果未給定或值為 0,則訊息將無限期顯示,直到使用此方法(第一個參數中的
false
)隱藏。- 回傳
用於鏈接的 DataTables API 實例。
範例
顯示通知訊息 3 秒
var table = new DataTable('#myTable');
table.buttons.info('Notification', 'This is a notification message!', 3000);
設定按鈕的動作以顯示載入訊息,然後在 Ajax 處理完成時顯示完成訊息
var table = new DataTable('#myTable');
table.button(0).action(function () {
table.buttons.info('Please wait', 'Processing data...');
$.ajax({
// ...
success: function () {
table.buttons.info('Complete', 'Data processing complete', 2000);
}
});
});