validationEngine 是功能相當完整的表單驗證元件,自帶錯誤提示樣式,支援的規則大致分為幾類:
字串類:必填、最大/最小長度、兩欄相等、僅數字與空白、僅數字與英文字母。
數字類:數字、整數、最大值、最小值。
日期類:日期(yyyy-MM-dd / yyyy/MM/dd 等)、日期含時間、最小/最大日期、日期區間。
業務欄位:URL、email、phone、IPv4;中文優化版另擴充了 QQ、郵遞區號、身分證、漢字。
Ajax 後端驗證:支援全域擴充定義,訊息可由後端決定。
其他:可自訂規則。
原始碼:https://github.com/posabsolute/jQuery-Validation-Engine
中文 API 文件:https://code.ciaoca.com/jquery/validation-engine/
1. 引入
<link href="~/Scripts/validation/validationEngine.jquery.css" rel="stylesheet" /> <script src="~/Scripts/validation/jquery.validationEngine.js"></script> <script src="~/Scripts/validation/jquery.validationEngine-zh_CN.js"></script>
語系檔務必放在核心檔之後,它負責擴充中文規則與預設訊息。
2. HTML
<div class="panel panel-default">
<div class="panel-heading">
<div class="panel-title">常用業務欄位驗證</div>
</div>
<div class="panel-body">
<form role="form" id="form1" class="demoform" action="#">
<div class="form-group">
<label class="control-label">分類:</label>
<select class="form-control validate[required]" name="type">
<option value="">==請選擇==</option>
<option value="1">一星級</option>
<option value="2">二星級</option>
<option value="3">三星級</option>
</select>
</div>
<div class="form-group">
<label class="control-label">多選框(至少勾兩項):</label>
<label class="checkbox-inline">
<input class="validate[minCheckbox[2]]" type="checkbox" name="chb1" />一星級
</label>
<label class="checkbox-inline">
<input class="validate[minCheckbox[2]]" type="checkbox" name="chb1" />二星級
</label>
<label class="checkbox-inline">
<input class="validate[minCheckbox[2]]" type="checkbox" name="chb1" />三星級
</label>
</div>
<div class="form-group">
<label class="control-label">單選框:</label>
<label class="radio-inline"><input class="validate[required]" type="radio" name="rad1" />男</label>
<label class="radio-inline"><input class="validate[required]" type="radio" name="rad1" />女</label>
<label class="radio-inline"><input class="validate[required]" type="radio" name="rad1" />其他</label>
</div>
<div class="form-group">
<label class="control-label">簡介:</label>
<textarea class="form-control validate[required]"></textarea>
</div>
<div class="form-group">
<label class="control-label">上傳圖片:</label>
<input type="file" class="form-control validate[required]" />
</div>
<div><br /><br />
<input type="submit" class="btn btn-success" value="提交" />
</div>
</form>
</div>
</div>
兩個容易忽略的細節:select 的每個 option 都必須有 value(沒有值也要寫空字串),否則驗證會誤判;checkbox / radio 的錯誤訊息會顯示在第一個按鈕附近,而非各自下方。
3. JS
$(function () {
$('.demoform').validationEngine({
promptPosition: 'bottomRight', // 提示位置
addPromptClass: 'formError-white' // 自訂提示樣式
});
});

1. 後端回應格式
回傳的 JSON 陣列固定第一個元素是收到的 fieldId(布林值),第二個是驗證結果,第三個(若有)作為提示訊息:
public JsonResult Exists(string fieldId, string fieldValue)
{
if (fieldValue.Length > 3) return Json(new object[] { fieldId, true });
return Json(new object[] { fieldId, false });
}
public JsonResult GetInfoByCode(string fieldId, string fieldValue)
{
if (fieldValue.Length > 3) return Json(new object[] { fieldId, true, "張三豐" });
return Json(new object[] { fieldId, false, "驗證失敗" });
}
public JsonResult GetByName(string fieldId, string fieldValue)
{
if (fieldValue.Length > 3)
return Json(new object[] { fieldId, true, "後台驗證成功",
new { name = "張三豐", age = 20 } });
return Json(new object[] { fieldId, false, "驗證失敗,來自後台的消息" });
}
2. 擴充 ajax 規則
在 jquery.validationEngine-zh_CN.js 中加上規則定義,指定對應的後端端點。

3. HTML 宣告
<form role="form" id="form1" class="demoform" action="#">
<div class="form-group">
<label class="control-label">昵稱:</label>
<input class="form-control validate[required,ajax[ajaxNickName]]" name="nickname" />
</div>
<div class="form-group">
<label class="control-label">編號:</label>
<input class="form-control validate[required,ajax[ajaxCode]]" name="code" value="12" />
</div>
<div>
<input type="submit" class="btn btn-success" value="提交" />
</div>
</form>
4. JS 設定
$('.demoform').validationEngine({
promptPosition: 'bottomRight',
ajaxFormValidationMethod: 'post', // Ajax 提交方式
ajaxFormValidation: true, // 啟用 Ajax 模式提交表單
onAjaxFormComplete: function (status, form, json, options) {
console.info(status);
console.info(form);
},
onBeforeAjaxFormValidation: function (form, options) {
console.info(form);
}
});

單欄位的 ajax 規則沒有提供回呼,因此「驗證通過後順便帶回資料填入其他欄位」這類需求無法靠 ajax 規則完成,必須自行發請求。此外,前端驗證終究只是使用者體驗的優化,任何規則在後端都必須再驗一次——身分證格式檢查、金額上下限、必填與否,都不能只依賴瀏覽器。最後,這個插件最後一次主要更新已有一段時間,若專案導入 ES6 與打包工具,可考慮改用 validator 或 yup 這類可與框架整合的方案,把規則寫成函式而非 class 字串,型別與可測試性都更好。