本文是在前兩篇的基礎上改寫的。這次的主要目標是把提示文字與樣式從驗證邏輯裡徹底剝離出來,全部改成可傳參數,同時補上 radio、checkbox、select 的驗證。
第二篇提到的問題在舊版驗證中同樣存在,這次改寫順手解決了幾個。radio/checkbox/select 的驗證也補上了,但日期型別的驗證仍未完成,後續再補。
onEmptyText 輸入為空時顯示的文字 onEmptyClass 輸入為空時套用的樣式 onSuccessText 驗證通過顯示的文字 onSuccessClass 驗證通過套用的樣式 onErrorText 驗證失敗顯示的文字 onErrorClass 驗證失敗套用的樣式 onFocusText 取得焦點時顯示的文字 onFocusClass 取得焦點時套用的樣式 dataType 資料型別:text / number / date min 允許的最小值(或最小長度) max 允許的最大值(不含) targetId 顯示提示訊息的目標元素 id
目前支援 text、number、date 三種型別,其中 date 尚未實作。radio、checkbox、select 只驗證是否選中/選中數量,不做文字或日期判斷。另外 select 對 blur 事件的反應不夠即時,所以改用 change 事件來驗證。
$.fn.extend({
checkRange: function (inputArg) {
// 取得焦點
$(this).bind("focus", function () {
var flag = true;
if ($(this).is("input") || $(this).is("textarea")) {
if ($(this).attr("type") == "radio" || $(this).attr("type") == "checkbox") {
var name = $(this).attr("name");
if ($('input[@name="' + name + '"][checked]').length > 0) { flag = false; }
} else {
if ($(this).val() != undefined && $(this).val() != "") { flag = false; }
}
}
// select 沒有 focus 事件,改由 change 處理
if (flag) {
addText(inputArg.targetId, inputArg.onFocusText);
addClass(inputArg.targetId, inputArg.onFocusClass);
}
});
// 失去焦點
$(this).bind("blur", function () {
var flag = false;
if ($(this).is("input") || $(this).is("textarea")) {
if ($(this).attr("type") == "radio" || $(this).attr("type") == "checkbox") {
var name = $(this).attr("name");
var items = $('input[@name="' + name + '"][checked]');
if (items != undefined && items.length >= inputArg.min
&& items.length < inputArg.max) { flag = true; }
} else {
var value = $(this).val();
if (value == undefined || value == "") {
addText(inputArg.targetId, inputArg.onEmptyText);
addClass(inputArg.targetId, inputArg.onEmptyClass);
} else {
switch (inputArg.dataType) {
case "text":
flag = !(value.length < inputArg.min || value.length >= inputArg.max);
break;
case "number":
if (isNaN(value)) { flag = false; }
else { flag = !(value < inputArg.min || value >= inputArg.max); }
break;
case "date":
break; // 待實作
}
}
}
}
addMessage(flag, inputArg);
});
// select 用 change 事件驗證,支援多選數量檢查
if ($(this).is("select")) {
$(this).bind("change", function () {
var items = $(this).find("option:selected");
addMessage(
items != undefined && items.length >= inputArg.min
&& items.length < inputArg.max,
inputArg);
});
}
}
});
// 依驗證結果統一輸出提示與樣式
function addMessage(flag, inputArg) {
if (flag) {
addText(inputArg.targetId, inputArg.onSuccessText);
addClass(inputArg.targetId, inputArg.onSuccessClass);
} else {
addText(inputArg.targetId, inputArg.onErrorText);
addClass(inputArg.targetId, inputArg.onErrorClass);
}
}
function addText(targetId, text) {
if (text == undefined) { text = ""; }
$("#" + targetId).html(" " + text);
}
function addClass(targetId, className) {
if (className != undefined && className != "") {
$("#" + targetId).removeClass();
$("#" + targetId).addClass(className);
}
}
這次重構把重複出現的「顯示文字+切換樣式」抽成 addMessage,程式碼量少了幾乎一半,可讀性也上來了。
文字框長度不符:

數字驗證——取得焦點、超出範圍、通過:

checkbox 群組驗證:

select 多選數量驗證:

$(document).ready(function () {
$("#txtName").checkRange({
onFocusText: "必填項", onFocusClass: "notice", targetId: "txtNameTip",
onSuccessText: "驗證成功", onSuccessClass: "correct",
onErrorText: "請認真填寫", onErrorClass: "error",
min: 6, max: 12, dataType: "text"
});
$("#txtAge").checkRange({
onFocusText: "必填項", onFocusClass: "notice", targetId: "txtAgeTip",
onSuccessText: "驗證成功", onSuccessClass: "correct",
onErrorText: "輸入的範圍為 10-60", onErrorClass: "error",
min: 10, max: 60, dataType: "number"
});
// checkbox 群組:至少選 1 個、最多 3 個
$("#rdbMan1,#rdbWoman2,#rdbMan3,#rdbWoman4").checkRange({
onFocusText: "必填項", onFocusClass: "notice", targetId: "txthobbyTip",
onSuccessText: "驗證成功", onSuccessClass: "correct",
onErrorText: "請認真填寫", onErrorClass: "error",
min: 1, max: 3, dataType: "text"
});
// 多選 select:選 1 項
$("#ddlOption").checkRange({
onFocusText: "必填項", onFocusClass: "notice", targetId: "ddlOptionTip",
onSuccessText: "驗證成功", onSuccessClass: "correct",
onErrorText: "請認真填寫", onErrorClass: "error",
min: 1, max: 2, dataType: "number"
});
});
一個必須修正的寫法:範例中用的 $('input[@name="xxx"][checked]') 是 jQuery 1.2 的老語法,1.3 之後 @ 前綴已移除,必須改寫成 $('input[name="xxx"]:checked'),否則在現代版本上會直接拋出語法錯誤。
後續會持續更新,特別是日期驗證的部分。