DIV CSS 佈局教程網

jQuery.validationEngine 表單驗證插件使用指南
編輯:JQuery入門技巧     

一、能力概覽

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'   // 自訂提示樣式
    });
});

四、Ajax 後端驗證

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 字串,型別與可測試性都更好。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved