userguide.html

客户端数据验证框架

子节点：field，一个或者多个</p>
<p><u>field: </u>虚拟表单域，通过name映射表单中的实际域<br>
属性：name: 表单中的域的名称，例如input name=&quot;abc&quot;，此处则对应abc。     
必须<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; display-name:     
表单的显示名称。当校验失败时，会显示这个属性。必须<br>
&nbsp;&nbsp;&nbsp;&nbsp; onfaile: 与form中的onfail一样。尚未实现。可选<br>    
子节点：depend，一个或多个</p>
<p><u>depend</u>: 校验条件<br>    
属性：name: 校验条件的名称，必须为下面指定的13中名称之一，大小写敏感。必须。<br>    
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; param0-param4，5个参数，根据name不同，各有不同取值。</p>    
<p>一个范例：
<table class="CodeTable" width="100%">
  <tr>
    <td width="100%">&lt;!--校验登陆，简单。复杂的例子请看Demo--&gt;<br>
      &lt;validation-config&gt;<br>
      &nbsp;&nbsp;&nbsp; &lt;form id=&quot;loginForm&quot;    
      show-error=&quot;alert&quot; onfail=&quot;&quot;&gt;<br>   
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;field name="username" display-name="用户名" onfail=""&gt;<br>   
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;    
      &lt;depend name=&quot;required&quot; /&gt;<br>   
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;depend name="commonChar" /><br>    
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;/field&gt;<br>   
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;field    
      name=&quot;password&quot; display-nam=&quot;密码&quot;    
      onfail=&quot;&quot;&gt;<br>
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;    
      &lt;depend name=&quot;required&quot; /&gt;<br>   
      &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;/field&gt;<br>   
      &nbsp;&nbsp;&nbsp; &lt;/form&gt;<br>   
      &lt;/validation-config&gt;</td>
  </tr>
</table>
<p><a name="5.3"></a><b><font color="#FF0000">5.3 校验表单</font> [<a href="#">top</a>]</b></p>  
<p>编写完validation-config.xml后，就可以按照上面的部署方法进行部署。</p>
<p><a name="6"></a><b><font color="#FF0000">6 JSValidation支持的13种验证 </font>[<a href="#">top</a>]</b></p>
<table border="1" width="100%" height="424">
  <tr bgcolor="#CCCCCC">
    <td width="1%" height="18">name</td>
    <td width="31%" height="18">描述</td>
    <td width="29%" height="18">参数含义</td>
  </tr>
  <tr>
    <td width="1%" height="18">required</td>
    <td width="31%" height="18">必须，代表这个域不能为空</td>
    <td width="29%" height="18">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="18">integer:</td>
    <td width="31%" height="18">没有或者必须为整数</td>
    <td width="29%" height="18">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="16">double:</td>
    <td width="31%" height="16">允许为空或者必须为double数</td>
    <td width="29%" height="16">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="18">commonChar</td>
    <td width="31%" height="18">普通英文字符：字母数字和下划线</td>
    <td width="29%" height="18">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="18">chineseChar:</td>
    <td width="31%" height="18">中文字符</td>
    <td width="29%" height="18">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="18">minLength:</td>
    <td width="31%" height="18">最小长度，</td>
    <td width="29%" height="18">param0为最小长度数值</td>
  </tr>
  <tr>
    <td width="1%" height="18">maxLength:</td>
    <td width="31%" height="18">最大长度，</td>
    <td width="29%" height="18">param0为最大长度数值</td>
  </tr>
  <tr>
    <td width="1%" height="18">email:</td>
    <td width="31%" height="18">必须为Email格式</td>
    <td width="29%" height="18">无参数</td>
  </tr>
  <tr>
    <td width="1%" height="36">date:</td>
    <td width="31%" height="36">必须为日期格式，</td>
    <td width="29%" height="36">param0必须为yyyy-mm-dd,或者三个占位符的任意排列顺序。连接字符任意如dd/mm/yyyy</td>
  </tr>
  <tr>
    <td width="1%" height="36">mask:</td>
    <td width="31%" height="36">允许自定义正则表达式来进行校验</td>
    <td width="29%" height="36">param0为表达式字符串</td>
  </tr>
  <tr>
    <td width="1%" height="36">integerRange:</td>
    <td width="31%" height="36">整数范围必须在参数0和参数1之间。</td>
    <td width="29%" height="36">param0和param1必须能被转化成整数</td>
  </tr>
  <tr>
    <td width="1%" height="36">doubleRange:</td>
    <td width="31%" height="36">double数的范围必须在参数0和参数1之间</td>
    <td width="29%" height="36">参数0和参数1必须能被转化成Float。</td>
  </tr>
  <tr>
    <td width="1%" height="36">equalsField:</td>
    <td width="31%" height="36">必须与某一个域的值相等</td>
    <td width="29%" height="36">param0：同一个表单中域的名称。例如用来校验密码</td>
  </tr>
</table>
<p><b><a name="7"></a><font color="#FF0000">7 其他补遗 </font>[<a href="#">top</a>]</b></p> 
<p>暂无</p> 
</td>
</tr>
</table>
<table class="BottomTable" cellpadding="0" align="center">
<tr><td align="right">
<i>This software developed by Michael Chen. 2004/04<br>    
Please visit <a href="http://www.cosoft.org.cn/projects/jsvalidation">www.cosoft.org.cn/projects/jsvalidation</a> for update.     
</i>
</td></tr></table>

</body>

</html>