《表单验证jquery插件formvalidator使用方法详解手册》由会员分享，可在线阅读，更多相关《表单验证jquery插件formvalidator使用方法详解手册（11页珍藏版）》请在金锄头文库上搜索。
1、第三方手册 jQuery formValidator 手册PHPCMS V9 中使用的表单验证框架为 jQuery formValidator什么是 jQuery formValidator？jQuery formValidator 表单验证插件是客户端表单验证插件。 在做 B/S 开发的时候，我们经常涉及到很多表单验证，例如新用户注册，填写个人资料，录入一些常规数据等等。在这之前，页面开发者（JavaScript 开发者）需要编写大量的 JavaScript 来进行表单元素的校验，而这些校验在平时开发中不停的重复书写。 常见的校验如不能为空，必须满足长度要求，必须为数字，必须为Email 等
2、等。一般要判断的表单元素比较多，开发过程就显得枯燥无味重复的代码不断重复，而且可能还要兼容多种浏览器，更多的考虑因素使人头疼不已。由于每个要校验的页面虽然逻辑基本相同，但是在大多数情况下，出于种种原因，开发者宁愿再编写一套 JS 文件，为了便于管理。 jQuery formValidator 表单插件致力于改善这一过程。你只关心业务逻辑，而无需关系实现过程,只需简单的配置，无需写代码就能实现表单的检验。它包括常规检验功能和可扩展校验功能。针对每个表单元素你只需要写一行配置信息就能完成校验。而这些配置信息无需写入表单元素，实现了 js 代码和 html 代码的分离。这样做的好处，使 B/S 开发
3、过程中，分工更加明确，页面设计着只需关心他的页面（设计的时候不必担心把脚本弄坏了），javascript 开发者只需关心脚本的开发。 而插件本身包含的校验方式可以有无数种，只要你扩展正则表达式和函数。本插件于同类校验插件最大的区别：校验功能可以扩展；实现了校验代码于 html 代码的完全分离；你只需写一行配置信息就能完成一个表单元素的所有校验。插件本身提供了很多回调函数，使调用者能最大限度的发挥自己的想象能力来完成自己的业务需求。 在同一个页面你可以拥有很多个校验组，你只需在提交的按钮那里调用 return jQuery.formValidator.pageIsValid(校验组号) 来完成多
4、个组的校验，互不干扰。 插件具备跨浏览器的能力。目前在ie 和 ff 两种浏览器下调试通过，你不用再考虑在多浏览器下如何兼容，jQuery formValidator 帮你做到了这些。jQuery formValidator 文件在 PHPCMS V9 中放置在哪里?web 目录staticsjsformvalidator.jsweb 目录staticsjsformvalidatorregex.js如何在 v9 中加载 jQuery formValidator?12formvalidator.js“ charset=“UTF-8“formvalidatorregex.js“ charset=“
5、UTF-8“jQuery formValidator 插件的 API 帮助目前支持 5 种大的校验方式，分别是：inputValidator（针对input、textarea、select 控件的字符长度、值范围、选择个数的控制）、compareValidator（提供 2 个对象的比较，目前可以比较字符串和数值型）、ajaxValidator（通过 ajax 到服务器上做数据校验）、regexValidator（提供可扩展的正则表达式库） 、functionValidator （提供可扩展函数库来做校验）每种格式支持的控件类型如下：inputtextarea select校验方式text r
6、adio checkbox file password textareaselect-oneinputValidatorcompareValidator ajaxValidator regexValidator functionValidator 如果你用了不支持的校验功能，插件将忽略这个校验功能。插件目前提示错误，有两种模式：showword 和 showalert,即文字提示和窗口提示，下面的 4 大验证方式，针对 showalert 这种方式不是都必须的，有些配置是没有作用的下面分别罗列全局初始化和 5 种校验方式公开的属性formValidator:用来做初始化的类型，必须先执行。（“
7、为 showalert 可用参数属性属性名称默认值showalert详细解释validatorgroup校验组“1“一个页面的控件可以分成多个组，分开校验empty是否可以为空false automodify输入错误离开焦点的时候，自动修复错误false先给出提示然后，自动修复，目前只支持text、file、textarea 三种类型onempty空时候的提示“输入内容为空“可以为空，为空时候的提示。为空者不显示onshow显示时候的提示“请输入内容“为空者不显示onfocus获得焦点的提示“请输入内容“为空者不显示oncorrect输入正确后的提示“输入正确“当你焦点离开控件的时候，如果输入
8、正确将出现该提示。为空者不显示tipid显示错误的容器 ID表单 ID+“Tip“如果不自动构建提示层，表示提示成的 ID 号如果自动构建提示层，表示提示层相对的目标控件tipcss自动构建的提示层的样式“left“:“10px“,“top“:“1px“,“height“:“20px“,“width“:“250px“主要用于定位自动构建的提示层forcevalid强制输入的值必须有效true是否把一个全角字符当做 2 个长度的参数defaultvalue默认值null所有 input 和select 表单。如果你不设置就保持原值，一旦设置就设为默认值。inputValidator：属性属性名称
9、默认值详细解释type比较“size“(对 select 无效)“size“:表示比较长度 ，默认值类型“number“:数值型比较“string“:字符型比较“date“:短日期类型“datetime“:长日期类型min最小长度/值0默认数值型。如果进行字符比较，请收入字符型对 select-one 而言 inputValidator 里的参数min 和 max 表示选择的索引号范围 对 select-multiple 而言 inputValidator 里的参数 min 和 max 表示选择的个数max最大长度/值99999999999同上onerror发生错误的提示“输入错误“为空者不显
10、示。onerrormin比min属性小的提null当用户输入的值比 min 属性小的时候的错误提示示onerrormax比max 属性大的提示null当用户输入的值比 max 属性大的时候的错误提示empty控件文本值是否允许两边为空两边都允许出现空默认值leftempty:true,rightempty:true,emptyerror:nullleftempty:表示左边是否允许为空rightempty:表示右边是否允许为空 emptyerror：出现该错误的时候的提示，如果为 null，则利用 onerror 属性来提示错误。compareValidator：属性属性名称 默认值详细解释d
11、esid要比较控件的 ID“要跟源目标进行比较的目标 IDoperateor比较符号“=“一共有如下几种类型:=、!=、=、=datatype数据类型“string“目前只支持 2 种:“string“、“number“,“datetime“,“date“onerror发生错误的提示“输入错误“为空者不显示。regexValidator:属性属性名称 默认值详细解释regexp正则表达式“采用的是显式构造函数 new RegExp(“pattern“,“flags“); 由于Javascript 中 被用作转义字符，所以在使用显示构造函数构造实例对象的时候，需要使用 代替param附加参数“i
12、“g：代表可以进行全局匹配。i：代表不区分大小写匹配。m：代表可以进行多行匹配。可以任意组合,当然也可以不加参数datatype数据类型“string“string“:自己写的表达式，“enum“:枚举名。具体请见 demo3.htm你可以自己修改、添加formValidatorRegex.js 里的枚举项目名和表达式。onerror:发生错误的提示“输入错误“为空者不显示。ajaxValidator:几乎所有的属性跟$.ajax()的属性一样，请参考$.ajax()函数的帮助属性属性名称默认值 详细解释type请求的类型“GET“POST“ 或 “GET“url发送到的 URL地址“ dat
13、atype返回的数据类型“html“xml、html、script、jsondata数据“ async是否以异步的方式发送true success当请求成功时调用的函数null processdata自动处理返回的数据为字符串true在默认的情况下，如果 data 选项传进的数据是一个对象而不是字符串，将会自动地被处理和转换成一个查询字符串complete当请求完成时调用的函数null beforesend当请求前时调用的函数null有个一个参数，根$.ajax 里的beforeSend 参数一样。buttons你点提交的按钮(组)jQuery对象null当你触发了 ajax 校验，butto
14、ns 里对应的按钮（组）就会灰掉，一直等待服务器返回数据为止error当请求失败时调用的函数“请求失败“你可以自己定义这个错误，在 error 里自动打出。为空者不显示。functionValidator属性属性名称默认值返回值的解释fun外部函数名()参数 1:元素的值,参数 2:元素对象默认当作处理过程true/false校验成功/失败字符串校验失败，返回值当作自定义错误无处理过程onerror发生错误的提示“输入错误“ 函数 return false 的时候，显示该错误信息公共函数:主要是设置全局参数和判断是否通过校验函数名函数说明$.formValidator.initConfig参数
15、：配置类型属性默认值说明validatorgroup “1“你要针对哪个组进行配置formid“要自动注册pageIsValid函数的表单 ID号alertmessagefalse是否弹出窗口autotipfalse是否自动构建提示层errorfocustrue发生错误的时候，第一个出错控件是否获得焦点forcevalidtrue是否一直输入正确为止才允许离开焦点widewordtrue是否把一个全角字符当做 2个长度onsuccessnull该组校验通过后的回调函数,返回 false，阻止表单的提交submitoncefalse校验通过后，是否灰掉所有的提交按钮onerrornull该组校验
16、失败后的回调函数，有两个参数 参数1一个校验没有通过的错误信息参数2一个校验没有通过的元素对象debugfalse是否处于调试模式。true:不提交表单$.formValidator.pageIsValid一个参数： 不是配置类型validatorgroup “1“你要针对哪个组进行验证$.formValidator.isOneValid一个参数： 当时设置验证的表单元素 ID。返回是否校验成功的信息。$.formValidator.setFailStatefunction(“tipid“,“显示的信息“)在 showword 模式下，如果你的额外校验没有通过，你可以通过它来设置成失败信息和状态$.formValidator.getLengthfunction(“表单元素 id“)checkbox 或 radiobutton 表示(同组)选择的个数。对 select-one，选择索引的值对 select-multiple，i
