Longway js 框架 使用

验证规则配置手册

需要用到的JS(按顺序):

• detect.js
• eventutil.js
• prototype.js
• longway.js

术语：

• 验证失败：指定的控件没有通过验证，即其不符合我们要求的格式。

规则配置文件基本格式:

<?xml version="1.0" encoding="utf-8" ?> <rules> <rule id="login" type="Alert" mode="BulletList" header="Error occurs:"> <validator impl="RequiredFieldValidator" ctrl="loginName" msg="LoginName must not be empty." ctn="loginNameError"> </validator> <validator impl="RequiredFieldValidator" ctrl="password" msg="Password must not be empty." ctn="passwordError"> </validator> ... </rule> </rules> 格式说明：

1. 有且只有一个根结点，元素名为rules。
2. rules包含１个或多个rule元素，rule的详细说明及属性见rule元素。
3. 每个rule元素包含１个或多个validator元素，validator的详细说明及属性见validator元素。

rule元素

属性名	允许为空	默认值	描述	取值区间及说明
id	否	N/A	此属性必须在一个页面加载的所有规则配置文件中唯一，且在被引用的页面中存在对应的html元素。	N/A
type	是	Individual	指出验证时机及验证失败时错误消息的输出方式。	Individual: 在调用Longway.ValidationRuleFactory.validate(ruleId)时和各Html表单控件onchange触发时进行验证。各validator错误消息单独输出，输出区域由各validator的ctn属性决定。 Summary: 仅在调用Longway.ValidationRuleFactory.validate(ruleId)时触发验证。错误消息汇总后输出，输出区域由当前rule元素的ctn属性决定。 Alert:　仅在调用Longway.ValidationRuleFactory.validate(ruleId)时触发验证。错误消息汇总后弹出警告框输出。
ctn	当当前rule元素的type="Summary"时，此属性必须；否则此属性将被忽略。	N/A	当type="Summary"时，用于输出汇总后的错误消息的HTML元素。该元素将被用来显示错误消息，所以最好选择div,span,label等易于显示方便的HTML元素。	当前页面上HTML元素的ID。
mode	是	BulletList	当type不等于Individual时，此属性指明输出消息的基本样式	List: 每条错误消息占一行。 BulletList: 当type等于Alert时，每条错误消息占一行，每行加以"-　"前缀。当type等于Summary时，使用无序列表<ul>输出，每条错误消息为一个<li> SingleParagraph:　所有错误消息连成单个段落汇总后输出。
header	是	空字符串	当type不等于Individual时，用于汇总错误消息的标题。	任意字符串。

validator元素

validator，验证器。每个验证器提供对某一个表单元素（或者字段、控件）的验证。Longway提供五种基本的验证器，validator的impl属性指明验证器的类型。impl的取值可以是下列中的一种：

• RequiredFieldValidator: 必填字段验证器
• RegularExpressionValidator: 正则表达式验证器
• RangeValidator: 范围验证器
• CompareValidator: 比较验证器
• CustomValidator:自定义验证器

所有验证器具备一些共有的属性：

属性名	允许为空	默认值	描述	取值区间及说明
msg	否	N/A	错误消息。验证失败时，输出到页面上的提示信息。	N/A
ctrl	否	N/A	此属性指明需要验证的表单元素。	某表单元素的ID
ctx	所属rule的type等于Individual时，此属性必须提供。	N/A	错误消息的输出容器，即页上某个元素的Id。验证失败时，该元素的内容(即innerHTML)将被错误消息取代，验证通过时，其Body会被清空。	当前页面上HTML元素的ID。

每种验证器的详细说明及其特有属性如下：

RequiredFieldValidator (必填字段验证器)

验证指定控件的值不能为空或由空白字符组成。无特有属性。

RegularExpressionValidator (正则表达式验证器)

验证控件的值是否符合指定的正则表达式，注：验证时是全文匹配。

属性名	允许为空	默认值	描述	取值区间及说明
regex	否	N/A	用于验证的正则表达式（Perl风格)，当控件的值不匹配此正则表达式时，验证失败。	N/A

RangeValidator (范围验证器)

验证控件的值是否在指定范围内。即验证： min <= ctrl.value <= max。

属性名	允许为空	默认值	描述	取值区间及说明
min	否	N/A	最小值	N/A
max	否	N/A	最大值	N/A
type	是	String	被验证控件的数据类型	Integer:整型 Double:浮点型 Currency:金额。注：未经测试，暂勿使用。 Date:日期。指明控件的值必须是日期类型，格式由fmt及sprt属性决定。 String:字符串
sprt	是	N/A	当type等于Date时，此属性指明日期各段之间的分隔符。	- /
fmt	是	ymd	当type等于Date时，此属性指明日期的格式。	ymd:年月日，比如 1980-4-23 mdy:月日年，比如 4/23/1980 dmy:日月年，比如 23-4-1980 注：分隔符由sprt属性决定。

CompareValidator (比较验证器)

验证控件的值与另一控件或某常量的大小关系，也可用作数据类型检查。

属性名	允许为空	默认值	描述	取值区间及说明
op	Equal	N/A	用于进行比较的操作符	DataTypeCheck:数据类型检查 NotEqual或者!=:不等于 GreaterThan或者>=:大于等于 LessThan或者>:小于 LessThanEqual或者&lgt;=:小于等于 Equal或者==:等于。事实上，其他其他任意字符串也是“等于”，不过推荐使用Equal。
comp	是	N/A	欲与之比较的控件。如果此属性不为空且指向的控件存在，则验证关系为 ctrl op comp	某表单元素的ID
value	是	null	欲与之比较的值。如果ControlToValidate为空或指向的控件不存在，且验证关系为 ctrl op value	N/A
type	是	String	被验证控件的数据类型	Integer:整型 Double:浮点型 Currency:金额。注：未经测试，暂勿使用。 Date:日期。指明控件的值必须是日期类型，格式由fmt及sprt属性决定。 String:字符串
sprt	是	N/A	当type等于Date时，此属性指明日期各段之间的分隔符。	- /
fmt	是	ymd	当type等于Date时，此属性指明日期的格式。	ymd:年月日，比如 1980-4-23 mdy:月日年，比如 4/23/1980 dmy:日月年，比如 23-4-1980 注：分隔符由sprt属性决定。

CustomValidator (自定义验证器)

使用自定义的Javascript方法进行验证。

属性名	允许为空	默认值	描述	取值区间及说明
func	否	N/A	该方法接受两个参数 val, args。其中val是指　CustomValidator本身，args包含两个字段 value与 isValid(注意大小写)。 args.value是待验证控件的值，args.isValid指示验证通过或失败。 自定义验证方法验证时，如果验证失败，则设置 args.isValid = false;否则直接退出即可。	N/A

示例： // 验证某控件的值不可以是 "administrator"。 function keywordValidate(val, args) { if (args.value == "administrator") { args.isValid = false; } }

常见验证技巧

验证输入框字符的长度必须大于等于６，小于等于１２。

<validator impl="RegularExpressionValidator" msg="密码最多12位，最少6位。" ctn="password_error" regex=".{6,12}" ctrl="password"> </validator> 导入需要的js脚本，

Longway.ValidationRuleFactory.initValidatorRule("do_test");

 添加这句js代码 文档加载完成执行，向Longway框架中添加需要验证的form ，参数为form的ID；

on_submin=function(){
 //验证方法参数为form  ID  若失败返回true
  if (!Longway.ValidationRuleFactory.validate("do_test") ) {
  return false;
 }
}

添加类似的验证代码，提交时执行，其中的

  if (!Longway.ValidationRuleFactory.validate("do_test") ) {
  return false;
 }

必须放在逻辑代码之前。

修改longway.js 文件

第680行左右， _validationConfigFiles: ["/validation.xml"],

数组中放的是写验证的xml文件的路径，可以多个。

编写validation.xml

<?xml version="1.0" encoding="utf-8"?>
<rules>
 <rule id="do_test" type="Individual" ctn="summaryError" mode="List" header="Detail Validation:">
 <validator impl="RequiredFieldValidator" ctrl="name" msg="姓名不能为空!" ctn="name_error" />
 <validator impl="RegularExpressionValidator  " ctrl="password" msg="请选择运营商" ctn="password_error" regex=".{6,18}"/>
 <validator impl="RequiredFieldValidator" ctrl="repassword" msg="联系人地址不能为空!" ctn="repassowrd_error"  op="Equal" comp="password" type="String"/>
</rule>

</rules>

常用验证RequiredFieldValidator 非空验证

 RegularExpressionValidator  正则表达式验证

RequiredFieldValidator 比较验证

ctrl   验证的空间id

ctn  显示提示信息的 <span>标签id

over