前言
使用$.fn.validatebox.defaults重写默认值对象。下载该插件翻译源码
validatebox(验证框)的设计目的是为了验证输入的表单字段是否有效。如果用户输入了无效的值,它将会更改输入框的背景颜色,并且显示警告图标和提示信息。该验证框可以结合form(表单)插件并防止表单重复提交。
源码
/**
* jQuery EasyUI 1.3.2
*
*翻译:qq 1364386878
*/
(function ($) {
//初始化函数
function init(jq) {
$(jq).addClass("validatebox-text");
};
//销毁方法
function _destroy(jq) {
var validatebox = $.data(jq, "validatebox");
validatebox.validating = false;
var tip = validatebox.tip;
if (tip) {
tip.remove();
}
$(jq).unbind();
$(jq).remove();
};
//绑定事件
function bindEvents(jq) {
var box = $(jq);
var validatebox = $.data(jq, "validatebox");
//绑定聚焦事件
box.unbind(".validatebox").bind("focus.validatebox", function () {
validatebox.validating = true;
validatebox.value = undefined;
(function () {
if (validatebox.validating) {
if (validatebox.value != box.val()) {
validatebox.value = box.val();
if (validatebox.timer) {
clearTimeout(validatebox.timer);
}
validatebox.timer = setTimeout(function () {
$(jq).validatebox("validate");
}, validatebox.options.delay);
} else {
validate(jq);
}
setTimeout(arguments.callee, 200);
}
})();
//绑定光标离开事件
}).bind("blur.validatebox", function () {
if (validatebox.timer) {
clearTimeout(validatebox.timer);
validatebox.timer = undefined;
}
validatebox.validating = false;
hideTip(jq);
//绑定鼠标上去
}).bind("mouseenter.validatebox", function () {
if (box.hasClass("validatebox-invalid")) {
showTip(jq);
}
//绑定鼠标离开事件
}).bind("mouseleave.validatebox", function () {
if (!validatebox.validating) {
hideTip(jq);
}
});
};
//显示提示
function showTip(jq) {
var message = $.data(jq, "validatebox").message;
var tip = $.data(jq, "validatebox").tip;
if (!tip) {
tip = $("<div class=\"validatebox-tip\">"
+ "<span class=\"validatebox-tip-content\">"
+ "</span>"
+ "<span class=\"validatebox-tip-pointer\">"
+ "</span>" + "</div>").appendTo("body");
$.data(jq, "validatebox").tip = tip;
}
tip.find(".validatebox-tip-content").html(message);
validate(jq);
};
//验证
function validate(jq) {
var validatebox = $.data(jq, "validatebox");
if (!validatebox) {
return;
}
var tip = validatebox.tip;
if (tip) {
var box = $(jq);
var tippointer = tip.find(".validatebox-tip-pointer");
var tipcontent = tip.find(".validatebox-tip-content");
tip.show();
tip.css("top", box.offset().top - (tipcontent._outerHeight() - box._outerHeight()) / 2);
if (validatebox.options.tipPosition == "left") {
tip.css("left", box.offset().left - tip._outerWidth());
tip.addClass("validatebox-tip-left");
} else {
tip.css("left", box.offset().left + box._outerWidth());
tip.removeClass("validatebox-tip-left");
}
tippointer.css("top", (tipcontent._outerHeight() - tippointer._outerHeight()) / 2);
}
};
//隐藏提示
function hideTip(jq) {
var tip = $.data(jq, "validatebox").tip;
if (tip) {
tip.remove();
$.data(jq, "validatebox").tip = null;
}
};
//验证
function _validate(jq) {
var validatebox = $.data(jq, "validatebox");
var options = validatebox.options;
var tip = validatebox.tip;
var box = $(jq);
var val = box.val();
function getmsg(msg) {
validatebox.message = msg;
};
//验证类型
function validTypeMd(validType) {
var results = /([a-zA-Z_]+)(.*)/.exec(validType);
var result = options.rules[results[1]];
if (result && val) {
var resultsVal = eval(results[2]);
if (!result["validator"](val, resultsVal)) {
box.addClass("validatebox-invalid");
var msg = result["message"];
if (resultsVal) {
for (var i = 0; i < resultsVal.length; i++) {
msg = msg.replace(new RegExp("\\{" + i + "\\}", "g"), resultsVal[i]);
}
}
getmsg(options.invalidMessage || msg);
if (validatebox.validating) {
showTip(jq);
}
return false;
}
}
return true;
};
if (options.required) {
if (val == "") {
box.addClass("validatebox-invalid");
getmsg(options.missingMessage);
if (validatebox.validating) {
showTip(jq);
}
return false;
}
}
if (options.validType) {
if (typeof options.validType == "string") {
if (!validTypeMd(options.validType)) {
return false;
}
} else {
for (var i = 0; i < options.validType.length; i++) {
if (!validTypeMd(options.validType[i])) {
return false;
}
}
}
}
box.removeClass("validatebox-invalid");
hideTip(jq);
return true;
};
//实例化验证框
$.fn.validatebox = function (target, parm) {
if (typeof target == "string") {
return $.fn.validatebox.methods[target](this, parm);
}
target = target || {};
return this.each(function () {
var validatebox = $.data(this, "validatebox");
if (validatebox) {
$.extend(validatebox.options, target);
} else {
init(this);
$.data(this, "validatebox", {
options: $.extend({},
$.fn.validatebox.defaults,
$.fn.validatebox.parseOptions(this), target)
});
}
bindEvents(this);
});
};
//默认方法
$.fn.validatebox.methods = {
//移除并销毁组件
destroy: function (jq) {
return jq.each(function () {
_destroy(this);
});
},
//验证文本框的内容是否有效
validate: function (jq) {
return jq.each(function () {
_validate(this);
});
},
//调用validate方法并且返回验证结果,true或者false
isValid: function (jq) {
return _validate(jq[0]);
}
};
//解析器
$.fn.validatebox.parseOptions = function (target) {
var t = $(target);
return $.extend({}, $.parser.parseOptions(target,
["validType",
"missingMessage",
"invalidMessage",
"tipPosition",
{ delay: "number" }]),
{ required: (t.attr("required") ? true : undefined) });
};
//默认属性和事件
$.fn.validatebox.defaults = {
required: false,//定义为必填字段
//定义字段验证类型,比如:email, url等等。可用值有:
//1).一个有效类型字符串运用一个验证规则。
//2).一个有效类型数组运用多个验证规则
validType: null,
delay: 200,//延迟到最后验证输入值
missingMessage: "This field is required.",//当文本框未填写时出现的提示信息
invalidMessage: null,//当文本框的内容被验证为无效时出现的提示
//定义当文本框内容无效的时候提示消息显示的位置,有效的值有:'left','right'
tipPosition: "right",
//验证规则
rules: {
//匹配E-Mail的正则表达式规则
email: {
validator: function (value) {
return /^((([a-z]|\d|[!#\$%&'\*\+\-\/=\?\^_`{\|}~]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])+(\.([a-z]|\d|[!#\$%&'\*\+\-\/=\?\^_`{\|}~]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])+)*)|((\x22)((((\x20|\x09)*(\x0d\x0a))?(\x20|\x09)+)?(([\x01-\x08\x0b\x0c\x0e-\x1f\x7f]|\x21|[\x23-\x5b]|[\x5d-\x7e]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(\\([\x01-\x09\x0b\x0c\x0d-\x7f]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF]))))*(((\x20|\x09)*(\x0d\x0a))?(\x20|\x09)+)?(\x22)))@((([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.)+(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.?$/i.test(value);
},
message: "Please enter a valid email address."
},
//匹配URL的正则表达式规则
url: {
validator: function (value) {
return /^(https?|ftp):\/\/(((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:)*@)?(((\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])\.(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5]))|((([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|\d|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.)+(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])*([a-z]|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])))\.?)(:\d*)?)(\/((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)+(\/(([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)*)*)?)?(\?((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|[\uE000-\uF8FF]|\/|\?)*)?(\#((([a-z]|\d|-|\.|_|~|[\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF])|(%[\da-f]{2})|[!\$&'\(\)\*\+,;=]|:|@)|\/|\?)*)?$/i.test(value);
},
message: "Please enter a valid URL."
},
//length[0,100]:允许在x到x之间个字符
length: {
validator: function (startlength, endlength) {
var len = $.trim(startlength).length;
return len >= endlength[0] && len <= endlength[1];
},
message: "Please enter a value between {0} and {1}."
},
//remote['http://.../action.do','paramName']:发送ajax请求需要验证的值,当成功时返回true
remote: {
validator: function (_2a, url) {
var data = {};
data[url[1]] = _2a;
var _2d = $.ajax({
url: url[0],
dataType: "json",
data: data,
async: false,
cache: false,
type: "post"
}).responseText;
return _2d == "true";
},
message: "Please fix this field."
}
}
};
})(jQuery);
示例代码
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Basic ValidateBox - jQuery EasyUI Demo</title>
<link rel="stylesheet" type="text/css" href="../../themes/default/easyui.css">
<link rel="stylesheet" type="text/css" href="../../themes/icon.css">
<link rel="stylesheet" type="text/css" href="../demo.css">
<script type="text/javascript" src="../../jquery-1.8.0.min.js"></script>
<script src="../../plugins2/jquery.parser.js"></script>
<script src="../../plugins2/jquery.validatebox.js"></script>
</head>
<body>
<h2>Basic ValidateBox</h2>
<div class="demo-info">
<div class="demo-tip icon-tip"></div>
<div>It's easy to add validate logic to a input box.</div>
</div>
<div style="margin:10px 0;"></div>
<div class="easyui-panel" title="Register" style="width:400px;padding:10px">
<table>
<tr>
<td>User Name:</td>
<td><input class="easyui-validatebox" data-options="required:true,validType:'length[3,10]'"></td>
</tr>
<tr>
<td>Email:</td>
<td><input class="easyui-validatebox" data-options="required:true,validType:'email'"></td>
</tr>
<tr>
<td>Birthday:</td>
<td><input class="easyui-datebox"></td>
</tr>
<tr>
<td>URL:</td>
<td><input class="easyui-validatebox" data-options="required:true,validType:'url'"></td>
</tr>
<tr>
<td>Phone:</td>
<td><input class="easyui-validatebox" data-options="required:true"></td>
</tr>
</table>
</div> </body>
</html>