先寫一個普通的 form,再交給 EasyUI 接管:
<form id="ff" method="post">
...
</form>
呼叫 form 之後,這個表單就會改用 Ajax 方式送出,不再進行整頁跳轉:
$('#ff').form({
url: '...',
onSubmit: function(){
// 在這裡做檢查,回傳 false 可中止送出
},
success: function(data){
alert(data);
}
});
若希望在自訂時機才送出,例如點擊某個非 submit 的按鈕,可用 submit 方法並直接帶入設定:
$('#ff').form('submit', {
url: '...',
onSubmit: function(){
// 回傳 false 可阻止提交
},
success: function(data){
alert(data);
}
});
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| url | string | 表單送出的目標網址。 | null |
| 名稱 | 參數 | 說明 |
|---|---|---|
| onSubmit | none | 送出前觸發,回傳 false 可阻止提交。 |
| success | data | 表單送出成功後觸發,參數為伺服器回應。 |
| onBeforeLoad | param | 發出請求載入資料前觸發,回傳 false 可取消。 |
| onLoadSuccess | data | 表單資料載入完成時觸發。 |
| onLoadError | none | 載入表單資料發生錯誤時觸發。 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| submit | options | 執行送出。options 可包含 url、onSubmit、success。 |
| load | data | 載入資料以填充表單。data 為字串時視為遠端 URL,為物件時視為本地紀錄。 |
| clear | none | 清空表單所有欄位。 |
| validate | none | 驗證所有欄位,全部通過時回傳 true。此方法需搭配 validatebox 外掛使用。 |
表單的「回填」與「送出」是兩條獨立的流程:編輯頁通常先用 load 把伺服器資料灌進欄位,使用者修改後再按 submit 回傳。由於 load 也是非同步的,若需要在資料載入後立刻做運算或預設值處理,請把邏輯寫在 onLoadSuccess 裡,而不是緊接著 load 之後。