widget
Version: <1.0>
talent validate
Date: < 2008-07-16 >
Public
www.jstrd.com , 2008
Page 1
Widget
Widget
Widget
Widget
Talent
Talent
Talent
Talent
validate
validate
validate
validate
1.
1.
1.
1.
简介
本文档从各方面介绍 js 验证框架。如果只是使用此框架，那么此文档完全多余，看例子就可以了。
如果看了例子后还不会使用的话，就没必要使用此框架了。
2.
2.
2.
2.
产生背景
当前开源界的 js 验证框架应该足够多了，而且花样百出。为何还要写这么一个 “ 重复 ” 的东西？回
答这个问题需要从此框架的一些特点说起
1 ，
足够灵活：可以对表元素随意地添加验证和取消验证。而我见过的其它框架都不支持随意添加
和取消验证，一般都是写在配置文件中，一旦某个字段被加上验证，便终身不得解脱。
2 ， 足够易用：为 n 个字段添加验证，只需一条语句。
3 ， 易扩展：添加一个新的验证器，非常简单。
4 ， 跨浏览器：在 ie 和 firefox 下测试通过。
3.
3.
3.
3.
两分钟上手
1 ， 将 js 目录拷到你的项目根目录下，看起来结构是 $web_project_root/js/validate/ …
2 ， 在你的 jsp 文件的 </head> 前加上如下语句 < %@include file="/js/validate/validate.jsp"% >
3 ， 为你要验证的字段加上验证如： new R equiredValidator () .add("n1", "n2"); //add 的参数为字段名字
（即 name 属性），参数可以有任意多个。
4 ，
在 form 元素中加上 onsubmit= ” return validate() ”
5 ，
提交你的表单，看看验证是不是已经起作用了
4.
4.
4.
4.
详细说明
使用的一般过程在 3 两分钟上手 中已有说明。本章列一下所有的使用内容
1 ，
验证器的命名规则，每个验证器类首字母都大写且都以 Validator 结尾如 EmailValidator
2 ，
每个验证器都有 add(name1, … ,nameN) ， remove(name1, … ,nameN) 方法以对字段进行添加和移除
验证（提示：如果有验证器会执行 remove 操作，需要给这个验证器定义一个变量以供 remove
时访问）。
3 ， 本框架中有使用到 Field 对象的地方，每个 Field 对象包括 label 和 name 属性。例如
var loginNameField = new Field( “ 用户名 ” , “ loginName ” );
4 ，
像 NumRangeValidator( 数字范围 ) 这类需要设置一些参数的验证器，都有如下特性
1 ，
有一个 set() 函数，此函数都会返回验证器本身，但各验证器此函数的参数个数不定，例如
DatetimeValidator 的 set 函数是一个参数，此参数设置日期的样式如 yyyy-mm-dd ，而
NumRangeValidator 的 set 函数有两个参数，分别为最小值和最大值。
2 ， 建议这样使用 new XxValidator().set(param).add(fieldName) 或 new
XxValidator().add(fieldName).set(param) 。
5 ，
列一下需要设置参数的验证器
