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,遇到此問題請重新下載新版。
formValidatorReg.js 擴充庫供自由增改。<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,能省下不少外掛成本。