`

JavaScript Validation Framework(JSValidation)用户手册

    博客分类:
  • js
阅读更多

来源:    2007-3-1 19:32:48 网友评论 0 条 字体:[ ] ~我要投稿!

1. JSValidation是什么?

如首页所说,JSValidation是客户端表单验证框架,用在BS系统中,或者简单的网页系统中。表单验证在这些开发中很常见:新用户注册,需要校验某些字段;用户登陆,需要校验;等等。在这之前,页面开发者(JavaScript开发者)需要编写大量的JavaScript来与表单对象交互,并进行校验。常见的校验如不能为空,必须满足长度要求,必须为数字,必须为Email等等。根据一般的经验,如果表单中需要校验的域个数超过10个,开发过程就显得枯燥无味——多段重复的代码不断重复,如果要求跨浏览器,更多的考虑因素使人头疼不已。往往这个页面的验证还不能用于那个验证……虽然逻辑基本相同;但是在大多数情况下,出于种种原因,开发者宁愿(或者没办法)重新编写另一个页面的JavaScript代码。

JSValidation致力于改善这一过程。它将常见的校验(目前支持13种)封装起来,并创造性的采用xml来存贮表单验证信息,使得表单的验证成为整个项目中最不重要的环节,开发者只需要定义几个xml标记,就可以创建出复杂的验证策略,而不用编写一行JavaScript代码。由于采用xml集中管理表单验证,使得表单验证在整个系统中的耦合度大大降低,并且易维护性大大提高。开发者更多的精力可以投入到业务相关的代码中。

恰恰相反,JSValidation内部结构虽然不太简单(对用户而言),但是调用方式却极其简单,配置好环境后,只需要在需要验证的表单的HTML标记中加上onsubmit="return doValidate('formId')"即可。这并没有改变开发者的习惯。

更为明显的优势是,JSValidation具备跨浏览器的能力。在目前的测试环境下,支持IE5及以上版本,Mozilla系列和支持DOM2模型的其他浏览器。你不用再考虑在多浏览器下如何兼容,JSValidation帮你做到了这些。

2. JSValidation能做什么,不能做什么?

如上所述,JSValidation能够校验表单。在系统复杂,表单复杂的场景下,JSValidation的优势更加突出。JSValidation目前能够完成客户端的13种验证如下:

  • 取值非空
  • 必须为整数
  • 必须为双精度数
  • 必须为普通英文字符(字母,数字,下划线)
  • 必须为中文字符
  • 最小长度
  • 最大长度
  • 是否为Email格式
  • 是否为日期格式(yyyy-mm-dd)
  • 自定义的正则表达式
  • 整数范围(大于某数小于某数)
  • 双精度数范围
  • 必须与某个域的值相同

所有这些验证都在客户端完成。如果还有在此之外的验证需求,请告诉我们,我们会跟据需求程度开发出新的验证模型。

JSValidation不能做的:

  • 跨页面的验证。例如,A页面输入值,必须满足B页面中某一个值的条件,或者更多的页面。这个需求需要用户的反馈。如果在现实开发中这种需求很普遍,我们会考虑开发。目前的替代方式是,将A页面需要验证的值POST到B页面的一个Hidden Field,然后再使用已有的验证方式。
  • 与服务器交互验证。最常见的是输入用户名密码后登录。限于它的表示范围,JSValidation不能完成这个工作。
  • 其他没有提到的,很希望你能告诉我们。

3. 什么情况下,我应该使用JSValidation?

答案是,如果没有现成的验证参考,就使用它吧。

有很多的开发工具、开发框架(模型)都已经提供了验证支持,如ASP.NET,Struts。但是还有更多的Framework没有提供支持,例如我们使用的Velocity(也许它不能称为框架),以及其他的ASP, PHP, Pure JSP, CGI等等。也许没有成熟的框架使用。如果没有,JSValidation也许能够帮助你减轻客户端校验编程的压力,让你有更多的精力投入对业务的关注中。

另外,如果你的系统很小,或者系统中需要校验的很少——例如只有一个登陆的用户名、密码需要校验,那么基于性能考虑,我们不建议你采用JSValidation。JSValidation库文件达到22KB,加上验证文件,也许要在你的页面上加载额外的26K+才能运行。而相同的功能,自己按照常规方式写也不过几行。

当然,如果你现有的开发过程中已经有了自己的模型,很熟悉也很牢固了,尽可能采用你自己的方式吧。JSValidation并非久经考验(before v1.0b)。

4. 快速开始

你可以有两种方法快速开始(看到效果)

无论是那种方法,演示的例子中都有详细的步骤,以及对应的代码。

5. 使用流程

以下介绍在实际开发中,如何配置使用JSValidation。在开始这些步骤之前,请保证你下载了最新版本的jsvalidation-framework.js文件。

5.1 配置环境

  1. 首先将jsvalidation-framework.js和validation-config.xml复制到网站的某一目录下,例如/javascripts。
  2. 打开jsvalidation-framework.js,找到var ValidationRoot = ""; 将这行代码更改为var ValidationRoot = "/javascripts/"; (就是validation-config.xml文件的位置)。
  3. 在你需要进行校验的页面中,加入jsvalidation的引用:
    <script language="javascript" src="/javascripts/jsvalidation-framework.js"></script>
  4. 在该页面需要验证的表单Form标记中,加入on submit="return doValidate('formId')"。其中formID是该Form的id。
  5. 完成。

5.2 编写validation-config.xml

validation-config.xml是集中管理表单的存放点,也是JSValidation处理验证条件的地方。

- 文件格式
    validation-config.xml是标准文本格式。你可以以任何文本编辑器来编辑它。在正式校验之前,请确保你的xml文件能够正常显示在浏览器中。
- 基本结构

<validation-config>              每个validation-config.xml都有一个validation-config根节点
    <form ...>                         可以进行一个或者多个form的校验
        <field ...>                     每个form有一个或者多个需要验证的表单域
             <depend ... />        每个域需要验证的条件可以有一个或者多个

- 节点说明
validation-config: 根节点
属性:lang: 所用的语言,可以是"auto", "zh-cn"(简体中文)或者"en-us"(英文)。默认为auto,可选。
子节点:form, 一个或多个

form: 虚拟表单,通过id映射网页中的表单
属性:id: 映射网页表单中的id,通过这个id,使得jsvalidation与实际网页表单相关联。必须
         show-error: 显示错误提示信息的方式。可以是alert(将会显示对话框)或者一个div的id(将会在这
      个div中显示错误消息)必须
      onfail: 当校验失败时,运行的自定义JS函数。可选(该版本尚未实现)
子节点:field,一个或者多个

field: 虚拟表单域,通过name映射表单中的实际域
属性:name: 表单中的域的名称,例如input name="abc",此处则对应abc。 必须
        display-name: 表单的显示名称。当校验失败时,会显示这个属性。必须
     onfaile: 与form中的onfail一样。尚未实现。可选
子节点:depend,一个或多个

depend: 校验条件
属性:name: 校验条件的名称,必须为下面指定的13中名称之一,大小写敏感。必须。
      param0-param4,5个参数,根据name不同,各有不同取值。

一个范例:

<!--校验登陆,简单。复杂的例子请看Demo-->
<validation-config>
    <form id="loginForm" show-error="alert" onfail="">
         <field name="username" display-name="用户名" onfail="">
             <depend name="required" />
             <depend name="commonChar" />
         </field>
         <field name="password" display-nam="密码" onfail="">
             <depend name="required" />
         </field>
    </form>
</validation-config>

5.3 校验表单

编写完validation-config.xml后,就可以按照上面的部署方法进行部署。

6 JSValidation支持的13种验证

name 描述 参数含义
required 必须,代表这个域不能为空 无参数
integer: 没有或者必须为整数 无参数
double: 允许为空或者必须为double数 无参数
commonChar 普通英文字符:字母数字和下划线 无参数
chineseChar: 中文字符 无参数
minLength: 最小长度, param0为最小长度数值
maxLength: 最大长度, param0为最大长度数值
email: 必须为Email格式 无参数
date: 必须为日期格式, param0必须为yyyy-mm-dd,或者三个占位符的任意排列顺序。连接字符任意如dd/mm/yyyy
mask: 允许自定义正则表达式来进行校验 param0为表达式字符串
integerRange: 整数范围必须在参数0和参数1之间。 param0和param1必须能被转化成整数
doubleRange: double数的范围必须在参数0和参数1之间 参数0和参数1必须能被转化成Float。
equalsField: 必须与某一个域的值相等 param0:同一个表单中域的名称。例如用来校验密码

 

 

 

 

 

评论

相关推荐

    JavaScript Validation Framework教程

    JavaScript Validation Framework是一个强大的客户端验证工具,它允许开发者在用户提交数据到服务器之前,在浏览器端进行数据有效性检查。这个框架简化了验证过程,提高了用户体验,并减少了服务器端的压力。本教程...

    jsvalidation-validation-framework.rar_jsvalidation

    JSValidation是一款基于JavaScript的前端验证框架,它使得在Web表单中实现数据验证变得简单而高效。这个框架的主要目的是帮助开发者在用户提交数据之前,确保输入的信息符合预设的规则,从而提高用户体验并减少...

    Js validation-framework 使用指南和详细配置

    &lt;script src="path/to/validation-framework.min.js"&gt; ``` ### 三、JSValidation的基本使用 创建验证规则是JSValidation的基础操作。你可以为每个表单元素指定验证规则,如下所示: ```javascript var validator ...

    JavaScript Validation API with DOM.zip

    JavaScript Validation API与DOM是Web开发中的重要组成部分,用于在客户端实现数据验证,提高用户体验并减轻服务器负担。在本文中,我们将深入探讨JavaScript Validation API以及它如何与DOM(文档对象模型)协同...

    Spring Framework 开发参考手册

    《Spring Framework 开发参考手册》是一本针对Java开发者的重要指南,尤其对于那些使用Spring框架进行企业级应用开发的程序员来说,它提供了全面且深入的指导。Spring是Java平台上的一个开源框架,以其依赖注入...

    Validation Framework-开源

    验证框架(Validation Framework)是一个专为创建和执行可重用验证逻辑而设计的开源软件库。这个框架的核心理念是提供一种高效、灵活且易于扩展的方式来验证数据或对象,确保它们符合预定义的规则和标准。在Java编程...

    ZendFramework中文手册HTML版

    5. **表单和验证(Forms and Validation)**:帮助构建和验证用户输入的数据。 6. **服务端认证和授权(Authentication and Authorization)**:提供安全的用户身份验证和权限控制。 **三、服务导向架构(SOA)支持...

    validation-framework验证框架

    `validation-framework`可能支持多种编程语言,如Java的Hibernate Validator、JavaScript的Joi等,它们都有各自的API和用法,但基本原理相同,都是通过定义规则和使用验证器来完成数据验证。 ### 集成到项目中 在...

    validation-framework.js

    客户端验证框架,用于客户端的验证是否为空

    jsvalidation

    JavaScript验证(JSValidation)是一种基于JavaScript的客户端验证技术,用于在用户提交表单前检查输入数据的有效性。这种验证方式可以提高用户体验,因为错误能够即时反馈,而无需等待服务器响应。"jsvalidation...

    Python库 | hbp_validation_framework-0.5.8.tar.gz

    《Python库:深入理解hbp_validation_framework》 在Python编程世界中,库是开发者们的重要工具,它们提供了丰富的功能,简化了开发流程。本文将详细探讨一个名为`hbp_validation_framework`的Python库,该库的版本...

    jQuery Validation 参考手册

    jQuery Validation 参考手册

    BeanValidation(jar,英文手册,中文手册)合集

    BeanValidation(jar,英文手册,中文手册)合集BeanValidation(jar,英文手册,中文手册)合集.rarBeanValidation(jar,英文手册,中文手册)合集.rarBeanValidation(jar,英文手册,中文手册)合集.rarBeanValidation(jar,英文...

    OVal - object validation framework-开源

    OVal是Java 5或更高版本的可扩展对象验证框架。 注释(@NotNull)或XML配置文件可用于表达类约束。 OVal可以选择使用AspectJ强制执行自动验证(DbC)如何使用:... bintray / jcenter?filterByPkgName = oval

    Java Validation Framework-开源

    Java Validation Framework(JVF)是一个开源的解决方案,旨在帮助开发者在Java应用程序中高效地处理业务规则验证。在快速发展的IT环境中,业务需求的频繁变化给系统设计和开发带来了挑战。为了应对这些变化,JVF...

    Input Validation Framework for .NET-开源

    输入验证框架(IVF)是专为.NET平台设计的一个开源工具,它提供了一种高效且灵活的方式来处理应用程序中用户输入的数据验证。IVF的核心理念是允许开发者定义和应用复杂的验证规则,以确保用户提交的信息符合预期的...

    jquery validation使用指南手册

    ### jQuery Validation 使用指南 #### 一、概述 `jQuery Validation` 是一款强大的客户端验证插件,它可以方便地集成到基于 `jQuery` 的项目中,帮助开发者实现表单数据的有效性和完整性验证。本指南旨在详细介绍 ...

Global site tag (gtag.js) - Google Analytics