ajaxSubmit() 來自 jQuery Form Plugin(jquery.form.js),並非 jQuery 核心功能。使用前需引入:
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.form/4.3.0/jquery.form.min.js"></script>
<form id="myForm" action="/api/submit" method="post">
<label>標題:<input type="text" name="title" /></label><br>
<label>內容:<textarea name="content"></textarea></label><br>
<button type="submit">提交</button>
</form>
綁定表單 submit 事件,呼叫 ajaxSubmit() 並處理回應:
$('#myForm').on('submit', function(e) {
e.preventDefault(); // 阻止預設提交
$(this).ajaxSubmit({
type: 'POST', // 提交方式
url: '/api/submit', // 目標 URL(可省略,預設取 form action)
dataType: 'json', // 預期回應格式
data: { // 額外資料(選填)
extra: 'value'
},
beforeSubmit: function(arr, $form, options) {
// 提交前驗證或顯示 loading
console.log('準備提交', arr);
return true; // 回傳 false 可取消提交
},
success: function(response, statusText, xhr, $form) {
console.log('提交成功', response);
alert('提交成功!');
$form.resetForm(); // 重置表單
},
error: function(xhr, statusText, errorThrown) {
console.error('提交失敗', errorThrown);
alert('提交失敗,請稍後再試');
}
});
});
| 選項 | 說明 |
|---|---|
| target | 指定更新內容的元素選擇器 |
| replaceTarget | 是否替換目標元素整體(預設 false 僅替換內容) |
| clearForm | 提交成功後清空表單 |
| resetForm | 提交成功後重置表單至初始狀態 |
| semantic | 是否依 HTML5 語意提交(如 button formaction) |
插件自動處理 <input type="file">,無需額外設定。確保表單有 enctype="multipart/form-data" 即可。