DIV CSS 佈局教程網

jQuery formValidator 表單驗證插件:功能、API 與下載
編輯:JQuery特效代碼     

formValidator 是一款功能相當完整的中文表單驗證插件,除了基本的長度與格式檢查,還支援多驗證組、AJAX 遠端驗證、四種狀態提示與自動產生提示層。以下整理它的核心能力與使用範例。

更新紀錄摘要

2008/7/17 3.1 版

  • 為 inputValidator 新增 empty 屬性,用於設定文字值左右兩側是否允許留空。這是個物件,預設 {leftempty:true, rightempty:true, emptyerror:null};emptyerror 為 null 時改用 onerror 的訊息。此屬性仅在 type:"size"(比對長度)時有效。
  • 修改自動產生提示層的語法:新增 relativeid(提示層相對定位的參照控件,留空則用當前控件 ID)與 tipid(自動產生提示層的 ID,留空則用「控件ID + Tip」命名)。
  • 修正 ajaxValidator 中 beforesend 未傳入唯一參數的問題。
  • 修正 ajaxValidator 在後端無法取得中文的問題。
  • 更新升級記錄與使用者手冊,並補充兩則問答。

2008/7/22 修掉了 AJAX 驗證在表單送出後仍停留於 loading 狀態的 bug,遇到此問題請重新下載新版。

主要功能

  • 支援所有類型的客戶端控件驗證,只要控件具備唯一 ID 與 type 屬性,並可使用 jQuery 全部的選擇器語法。
  • 可透過函式與正則表達式擴充,作者另外提供了 formValidatorReg.js 擴充庫供自由增改。
  • 兩種提示模式:文字提示(showword)與彈出視窗提示(showalert)。
  • 支援多驗證組,同一頁有多個提交按鈕、各自需要不同驗證規則時特別有用。
  • 四種狀態提示:頁面載入時、取得焦點時、失去焦點且驗證通過時、失去焦點且驗證失敗時,每一種都能獨立開關。
  • 自動產生並精準定位提示層,也可自訂錯誤訊息。
  • 可限制字元長度、數值範圍與勾選數量;範圍比對支援數值型與字元型,數量限制涵蓋 radio/checkbox/select 三種控件。
  • 支援兩個控件的值比對(字串與數值),以及伺服器端驗證與輸入格式驗證。

使用範例

<script type="text/javascript">
$(document).ready(function(){
  $.formValidator.initConfig({
    onError: function(){ alert("校驗沒有通過,具體錯誤請看錯誤提示"); }
  });

  // 長度限制:6~10 個字元
  $("#test1").formValidator({
    onshow:"請輸入用戶名",
    onfocus:"用戶名至少6個字符,最多10個字符",
    oncorrect:"恭喜你,你輸對了"
  }).InputValidator({ min:6, max:10, onerror:"你輸入的用戶名非法,請確認" });

  // 勾選數量限制:3~5 項
  $("#test2").formValidator({
    onshow:"請選擇你的興趣愛好(至少選擇3個,最多選擇5個)",
    onfocus:"你至少選擇3個,最多選擇5個",
    oncorrect:"恭喜你,你選對了"
  }).InputValidator({ min:3, max:5, onerror:"你選的個數不對(至少選擇3個,最多選擇5個)" });

  // 下拉選單必選
  $("#xueli").formValidator({
    onshow:"請選擇你的學歷",
    onfocus:"學歷必須選擇",
    oncorrect:"謝謝你的配合"
  }).SelectValidator({ onerror: "你是不是忘記選擇學歷了!" });

  // 兩次密碼比對
  $("#password1").formValidator({
    onshow:"請輸入密碼",
    onfocus:"兩次密碼必須一致哦",
    oncorrect:"密碼一致"
  }).InputValidator({ min:1, onerror:"密碼不能為空,請確認" })
    .CompareValidator({ desID:"password2", operateor:"=", onerror:"2次密碼不一致,請確認" });

  // 數值範圍:1~99
  $("#nl").formValidator({
    onshow:"請輸入的年齡(1-99歲之間)",
    onfocus:"只能輸入1-99之間的數字哦",
    oncorrect:"恭喜你,你輸對了"
  }).InputValidator({ min:1, max:99, type:"value", onerror:"年齡必須在1-99之間,請確認" });

  // 可留空,但填了就得正確:手機號碼
  $("#shouji").formValidator({
    empty:true,
    onshow:"請輸入你的手機號碼,可以為空哦",
    onfocus:"你要是輸入了,必須輸入正確",
    oncorrect:"謝謝你的合作",
    onempty:"你真的不想留手機號碼啊?"
  }).InputValidator({ min:11, max:11, onerror:"手機號碼必須是11位的,請確認" })
    .RegexValidator({ regexp:"^[1][0-9]{10}$", onerror:"你輸入的手機格式不正確" });

  // 可留空,但格式要對:聯絡電話
  $("#lxdh").formValidator({
    empty:true,
    onshow:"請輸入你的聯系電話,可以為空哦",
    onfocus:"你要是輸入了,必須輸入正確,格式例如:0577-88069620",
    oncorrect:"謝謝你的合作",
    onempty:"你真的不想留聯系電話了嗎?"
  }).RegexValidator({
    regexp:"^[0-9]{3}-|[0-9]{4}-]?([0-9]{8}|[0-9]{7})?$",
    onerror:"你輸入的聯系電話格式不正確"
  });
});
</script>

資源與使用提醒

API 說明文件與下載(含原始碼、範例):https://files.cnblogs.com/wzmaodong/formValidator4.0.1.zip。線上展示:https://www.yhuan.com/formvalidator/demo1.htm。

作者特別說明:使用過程中若遇到問題或發現 bug,請留言回報而非自行修改程式碼,讓插件能持續完善。同時也請保留原始碼中的版權聲明。

就今日的標準回看,這套插件的 API 設計以鏈式呼叫串接各類 validator,概念清楚且擴充容易,值得當作理解「驗證規則 should be composable」的教材。若用於新專案,仍建議評估是否直接採用 HTML5 內建的表單驗證屬性搭配 Constraint Validation API,能省下不少外掛成本。

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