bootstrapValidator 是一款相當好用的表單驗證套件,除了內建的驗證規則,它也允許我們掛上自訂的 callback 驗證邏輯。本文以一個開票表單為例,示範如何組合 notEmpty、numeric 與 callback 等多種驗證器,並處理驗證通過與失敗時的後續動作。
//表單驗證 issueInvoiceForm.validation = function(){ $('#issueInvoiceForm').on('init.field.bv', function(e, data) { var $icon = data.element.data('bv.icon'), options = data.bv.getOptions(), // Entire options validators = data.bv.getOptions(data.field).validators; // The field validators if (validators.notEmpty && options.feedbackIcons && options.feedbackIcons.required) { $icon.addClass(options.feedbackIcons.required).show(); } }).bootstrapValidator({ container:'popover', feedbackIcons: { required: 'glyphicon glyphicon-asterisk requiredStar', valid: 'glyphicon glyphicon-ok', invalid: 'glyphicon glyphicon-remove', validating: 'glyphicon glyphicon-refresh' }, fields: { invoiceDate:{validators: {notEmpty: {message: '開票日期不能為空'}}},//開票日期 code:{validators: {notEmpty: {message: '發票編碼不能為空'}}}, amount:{ validators:{ notEmpty: {message: '發票金額不能為空'}, numeric: {message: '發票金額只能輸入數字'}, callback: { message: '開票金額小於選中金額', callback: function(value, validator) { return false; } } } }, taxRate:{ validators:{ notEmpty: {message: '稅率不能為空'}, numeric: {message: '稅率只能輸入數字'} } }, taxAmount:{ validators:{ notEmpty: {message: '稅額不能為空'}, numeric: {message: '稅額只能輸入數字'} } }, },group:'.validateDiv' }).on('success.form.bv', issueInvoiceForm.issueInvoiceFormBtn).on('error.form.bv',function(){ $("#issueInvoiceFormBtn").removeAttr("disabled");//將保存按鈕去除disabled $(".has-error:visible:first").find(":input").focus(); }); };
幾個值得注意的細節:feedbackIcons 定義了各狀態對應的圖示;callback 驗證器可放入客製的商業邏輯(例如比對金額);成功時呼叫送出按鈕的處理函式,失敗時則移除按鈕的 disabled 並把焦點移到第一個錯誤欄位。掌握 callback 的彈性,就能應付各種內建規則無法涵蓋的驗證需求。