Validator对象主要用于页面级校验,开发人员可根据需要通过
<script type="text/javascript" src="Validator.js"></script>
方式将该js引入到相应的页面,通过在需校验的HTML标签上定义一些扩展属性即可,在Form提交事件中像如下方式调用来进行表单校验:
<script language="javascript">
function checkform(form) {
//@param {form} 表单form对象,如果只有一个form可document.forms[0]来取得该form对象
//@param {mode} : 校验模式,目前支持三种模式,具体值及涵义如下:
2 : 以alert方式弹出校验提示信息,同时对select和textare标签内的字体红色显示
3 : 则在相应的校验项右边以红色字体进行提示
不传 : 则以alert方式弹出校验提示信息
//@return boolean : true,通过校验; false:校验失败,并按照校验模式,给出不同的提示信息
return Validator.Validate(form,2);
}
</script>
该组件的调用还需要对需要校验的页面元素添加一些扩展属性,这些扩展属性有:
require, dataType, msg, to, regexp, format, min, max, accept, operator,具体解释如下:
request : 用来指定元素是否必输项,是和dataType配合使用
如果不指定,则默认为true,在表单提交时根据dataType进行校验;
如果指定为false,则表示该项为非必输项,只有输入有值才根据dataType进行校验,否则不进行校验
dataType : 指定校验的类型,目前支持的数据校验类型有:
IdCard | Chinese | Username | English | Url | SafeString | Repeat | Email | QQ | Range | Compare | Phone | Mobile | Date | Custom | Zip | Require | Group | Limit | LimitB | Filter
其中:dataType="Require"主要针对select进行校验,要求必须选择一项
dataType="Group"主要针对radio和checkbox进行分组校验
dataType="Username"主要真对用户名,其校验规则是第一个字符必须为a-z中的任意一个字符,后边必须是三个或者三个以上包括下划线的任何单词字符
dataType="SafeString"主要对密码的安全度进行校验
dataType="Chinese"主要校验是否中文
其他dataType可参考对应的实例。
msg : 提示信息
to : 目标值或页面元素名称,当和dataType="Repeat"配合使用时,to指定目标元素的名称;当和dataType="Compare"配合使用时,to指定目标值
regexp : 正则表达式,必须和Custom配合使用,当dataType指定为Custom时,将自动根据regexp指定的正则表达式来进行校验
format : 和dataType="Date"配合使用,主要对日期进行格式化,目前支持两种格式ymd、dmy
min : 和dataType="Group"、dataType="Limit"、dataType="LimitB"、dataType="Range"配合使用,分别指定对应类型的下限
max : 和dataType="Group"、dataType="Limit"、dataType="LimitB"、dataType="Range"配合使用,分别指定对应类型的上限
accept : 和dataType="Filter"配合使用,指定过滤的文件扩展名,如accept="jpg, gif, png",表示只支持三种类型文件的上传
operator : 和dataType="Compare"配合使用,指定比较方式。目前支持:NotEqual、GreaterThan、GreaterThanEqual、LessThan、LessThanEqual比较,如果不指定默认为是否相等比较
页面调用,对应标签如:
身份证号:<input name="Card" dataType="IdCard" msg="身份证号错误">
该对象同时具有良好的扩展性,可根据需要进行注册不同的校验方式或者通过自己写正则表达式来进行校验,如:
邮政编码:<input name="Zip" dataType="Custom" regexp="^[1-9]\d{5}$" msg="邮政编码不存在">
下面的示例演示了 Validator对象校验 组件的用法。