Events(事件)
- closeRequested
- formClosed
- formCreated
- formSubmitting
- loadingRecords
- recordAdded
- recordDeleted
- recordsLoaded
- recordUpdated
- rowInserted
- rowsRemoved
- rowUpdated
- selectionChanged
<a id="closeRequested"></a>
closeRequested(event, data)
當用戶點擊表格的關閉按鈕/圖標時會觸發此事件。如果showCloseButton 設置為true那么關閉按鈕就會顯示。此事件沒有參數(This event has no argument)。
<a id="formClosed"></a>
formClosed(event, data)
當添加或編輯表單關閉的時候會觸發此事件。data參數有以下字段:
- data.form:獲取這個表單的jQuery選擇器。
- data.formType:依據表單,可以是‘edit’或‘create’。
- data.row:如果是編輯表單,獲取當前編輯的行。
<a id="formCreated"></a>
formCreated(event, data)
當為記錄創建添加或編輯表單之后會觸發此事件。data參數有以下字段:
- data.form:獲取此表單的jQuery選擇器。
- data.formType:依據表單,可以是‘edit’或‘create’。
- data.record:如果是編輯表單,獲取當前編輯的記錄(例如,你可以從當前編輯記錄中獲取 name 字段,data.record.Name)。
- data.row:如果是編輯表單,獲取當前編輯的行。
<a id="formSubmitting"></a>
formSubmitting(event, data)
當點擊添加或編輯表單的保存/提交按鈕時觸發此事件。data參數有以下字段:
- data.form:獲取這個表單的jQuery選擇器。
- data.formType:依據表單,可以是‘edit’或‘create’。
- data.row:如果是編輯表單,獲取當前編輯的行。
你可以在這個事件中驗證表單。如果你在這個事件回調中返回false,那么提交操作將會被取消。
<a id="loadingRecords"></a>
loadingRecords(event, data)
在jTable加載數據發送AJAX請求到服務器之前觸發。此事件沒有參數。
<a id="recordAdded"></a>
recordAdded(event, data)
當用戶成功添加和保存一條記錄之后觸發。你可以用data.record參數來獲取添加的記錄。你可以用data.serverResponse來獲取服務器返回的 JSON object。
<a id="recordDeleted"></a>
recordDeleted(event, data)
當用戶成功刪除一條記錄的時候觸發。你可以用data.record參數來獲取刪除的記錄。你可以用data.row參數來獲取刪除的表行。你可以用data.serverResponse來獲取服務器返回的 JSON object。
<a id="recordsLoaded"></a>
recordsLoaded(event, data)
當jTable從服務器加載記錄和刷新表的時候會觸發此事件(如果開啟了分頁,當用戶改變當前頁碼的時候也會觸發此事件)。你可以用data.records來獲取所有的從服務器加載的數據。你可以用data.serverResponse來獲取服務器返回的 JSON object。
<a id="recordUpdated"></a>
recordUpdated(event, data)
當用戶成功更新一條記錄的時候會觸發此事件。你可以用data.record參數來獲取更新的記錄。你可以用data.row參數來獲取更新的表行。你可以用data.serverResponse來獲取服務器返回的 JSON object。
<a id="rowInserted"></a>
rowInserted(event, data)
當一行成功添加到展示的表格中的時候觸發。當用戶添加一條新紀錄獲取從服務器加載的數據都會插入一個新行。當從服務器加載數據完成之后,每一行都會調用rowInserted事件。所以,你可以修改行或做任何你想做的。你可以用data.row獲取當前行,你可以用data.record獲取對應的記錄、最后,如果這是一條新紀錄(用戶添加的),data.isNewRow會被jTable設置為true。
<a id="rowsRemoved"></a>
rowsRemoved(event, data)
當用戶刪除一行/多行(從服務器上刪除真實記錄)或者從服務器重新加載數據(清除所有行但是在服務器上不會刪除)。你可以用data.rows來獲取所有刪除的行的jQuery選擇器。你可以用data.reason獲取刪除的原因(可以是‘deleted’或‘reloading’)。
<a id="rowUpdated"></a>
rowUpdated(event, data)
當一行被更新的時候會觸發此事件。當用戶更新一條記錄時會更新對應的行。你可以用data.row獲取更新的行,用data.record獲取對應的記錄。此事件在 recordUpdated 之后觸發。
<a id="selectionChanged"></a>
selectionChanged(event, data)
不管是用任何方法,當表格上選中的行發生變化時會觸發此事件。當用戶選擇/取消選擇一行時,刪除所選行等等的時候會改變。你可以用 selectedRows 方法獲取選中的行。