Bootstrap Validator 是常見的前端表單驗證工具,但在多步驟表單、動態欄位或依條件顯示的情境中,驗證規則往往需要動態調整。本文以實作角度說明如何在不重置整個表單的情況下,停用驗證、清除錯誤狀態,並保留既有驗證流程。
$('#MaintainEntryForm').bootstrapValidator({
message: '輸入值無效!',
feedbackIcons: {
valid: 'glyphicon glyphicon-ok',
invalid: 'glyphicon glyphicon-remove',
validating: 'glyphicon glyphicon-refresh'
},
fields: {
Specifications: { validators: { notEmpty: { message: '請輸入規格!' } } },
ProductNameEN: { validators: { notEmpty: { message: '請輸入英文名稱!' } } },
ApplyUnit: {
validators: {
notEmpty: { message: '請輸入申報單位!' },
stringLength: { min: 1, max: 3, message: '申報單位最多輸入3位!' }
}
},
SuttleWeight: {
validators: {
callback: {
callback: function (value) {
var reg = /^\d{0,8}\.{0,1}(\d{1,3})?$/;
return parseFloat(value) > 0 && reg.test(value);
},
message: '淨重只能輸入大於0的整數或3位小數!'
}
}
}
}
}).on('success.form.bv', function (e) {
if (EntryInfo.SaveType == 1) {
EntryInfo.SaveEntryInfo();
} else if (EntryInfo.SaveType == 2) {
EntryInfo.SaveAndSubmitAudit();
}
});
這種寫法適合固定欄位,但當表單需要依使用者操作切換驗證條件時,就必須在執行階段調整驗證狀態。
實作上可先註冊完整規則,再於特定條件下將指定欄位設為未驗證狀態。Bootstrap Validator 會透過表單的 data 屬性保存實例,因此可用下列方式取得並操作:
$('#MaintainEntryForm')
.data('bootstrapValidator')
.updateStatus('ApplyUnit', 'NOT_VALIDATED', null);
這段程式的作用是讓 ApplyUnit 欄位暫時不參與驗證。若頁面後續又需要恢復驗證,可重新呼叫對應的驗證方法,或將狀態改回可驗證狀態後再次驗證。
如果欄位先前已驗證失敗並顯示錯誤,直接修改欄位值未必會立即移除提示。此時可先更新驗證狀態,再依需求重新驗證:
$('#MaintainEntryForm')
.data('bootstrapValidator')
.updateStatus('ApplyQty', 'NOT_VALIDATED', null);
透過這種方式,不需要重複初始化整個表單,也能讓畫面上的錯誤提示消失,適合動態表單與條件式驗證流程。