validationEngine
- ·jQuery v1.4.4+
注意事项：
1.演示版本为 v2.2.4；
2.v2.0 以下的版本参数并不完全通用；
对 validationEngine.jquery.css 文件进行修改，修改如下：
1.提示内容字体改为宋体；
2.去除中各浏览器的私有属性（各浏览器已经支持圆角和阴影，不再需要加私有属性）。
对 jquery.validationEngine.js 文件进行修改，修改如下：
1.将 312 行的 field.focus(); 注释掉，当有输入控件在 Table 内部时，验证会导致回到顶部的现象；
对 jquery.validationEngine-zh_CN.js 文件进行修改，修改如下：
1.修改部分提示文字；
2.增加两个对中文字符的验证规则：minSizeCN 和 maxSizeCN；
3.去除 “validate2fields”: {“alertText”:”* 请输入 HELLO”},
将以上两个JS文件进行合并
【options 参数说明】（可选）
| 名称 | 默认值 | 说明 |
|---|---|---|
| validationEventTrigger | “blur” | 触发验证的事件，支持事件可参考 jQuery 的事件说明。
PS：如果希望只在表单提交时验证，可以设置为空。 |
| scroll | true | 屏幕自动滚动到第一个验证不通过的位置 |
| focusFirstField | true | 验证未通过时，是否给第一个不通过的控件获取焦点 |
| promptPosition | “topRight” | 验证提示信息的位置，可设置为：”topRight”, “bottomLeft”, “centerRight”, “bottomRight” |
| autoPositionUpdate | false | 是否自动调整提示层的位置 |
| bindMethod | “bind” | 验证事件的绑定方式，可设置为：bind, live
PS：设置 live 似乎绑定事件无效，但是表单提交时能验证，建议不修改。[Demo] |
| binded | false | 是否已经绑定其他事件，设为 true 将不进行验证。 |
| inlineAjax | false | |
| ajaxFormValidation | false | 使用 Ajax 验证表单 |
| ajaxFormValidationURL | false | 设置 Ajax 验证的 URL，默认使用 form 的 action 属性 |
| ajaxValidCache | {} | |
| onAjaxFormComplete | $.noop | 表单提交，Ajax 验证完成后的行为（Function）[Demo] |
| onBeforeAjaxFormValidation | $.noop | 表单提交验证规则通过后，Ajax 验证之前的行为（Function）[Demo] |
| onValidationComplete | false | 表单提交验证完成时的行为（Function）
可以得到两个参数：表单元素 和 验证结果（ture or false）[Demo] |
| onSuccess | false | 实时验证所有项目都通过时，发生的行为（Function）[Demo] |
| onFailure | false | 实时验证有未通过项目时，发生的行为（Function）[Demo]
PS：onSuccess 和 onFailure 在禁用实时验证时无效。例如 validationEventTrigger 设为空，或 bindMethod 设为 live |
| isOverflown | false | 表单是否在溢出滚动的元素内（即外部元素设置了 overflow:scroll）
PS：设置为 ture 后，提示内容的插入位置将更改为在验证的控件之前插入； 此时需要在控件外层再套一个元素，并设置 class=”inputContainer” |
| overflownDIV | “” | 设置了溢出滚动的元素，格式为 jQuery 的选择器。 |
| showArrow | true | |
| isError | false | |
| InvalidFields | [] |
【使用方法】
载入 CSS 文件
<link rel="stylesheet" href="css/validationEngine.jquery.css">载入 JavaScript 文件
<script src="js/jquery.validationEngine.js"></script>
<script src="js/jquery.validationEngine-zh_CN.js"></script>
<!-- jquery.validationEngine-zh_CN.js 该文件为提示文字和自定义验证规则； 修改版已经将这两个文件合并，只需要载入 jquery.validationEngine.js； 另外，jQuery 插件当然还需要载入 jQuery 库，版本需在 jQuery 1.4.4 以上。 -->给表单加上 ID
<form id="form_id" ...>
...
</form>
<!-- ID 必须设置在 Form 标签中，否则无效 -->给控件加上 ID 及 设置验证类型
<input id="test_1" name="test_1" type="text" class="validate[required]">
<input id="test_2" name="test_2" type="checkbox" class="validate[required]">
<textarea id="test_3" name="test_3" class="validate[required]"><textarea>
<!-- validate[required] 表示必须填写 控件必须要设置 ID，但并不要求与 Name 相同 -->
设置验证
// 直接调用
$("#form_id").validationEngine();
// 自定义参数调用
$("#form_id").validationEngine("attach",{
promptPosition:"centerRight",
scroll:false
});
【验证类型】
<!-- 注：验证规则均写在 validate[] 中，如有多条规则，用英文逗号(,) 分割。 例：validate[required,minSize[6],custom[onlyLetterNumber]] -->
| 名称 | 示例 | 说明 |
|---|---|---|
| required | validate[required] | 表示必填项 |
| optional | validate[optional] | 表示可选项。若不输入，不要求必填，若有输入，则验证其是否符合要求。 |
| dateRange[name] | validate[dateRange[grp1]] | 验证日期范围 |
| dateTimeRange[name] | validate[dateTimeRange[grp1]] | 验证日期及时间范围 |
| minSize[int] | validate[minSize[6]] | 最少输入字符数 |
| maxSize[int] | validate[maxSize[20]] | 最多输入字符数 |
| groupRequired[name] | validate[groupRequired[grp2]] | 群组中至少输入一项 |
| min[int] | validate[min[1]] | 最小值（该项为数字的最小值，注意与 minSize 的区分） |
| max[int] | validate[max[9999]] | 最大值（该项为数字的最大值，注意与 maxSize 的区分） |
| past[date] | validate[past[2012/12/20]] | 日期必需在 date 或 date 的未来。date 格式可写作 YYYY/MM/DD、YYYY/M/D、YYYY-MM-DD、YYYY-M-D 或 now |
| future[date] | validate[future[now]] | 日期必须在 data 或 date 的过去。date 格式可写作 YYYY/MM/DD、YYYY/M/D、YYYY-MM-DD、YYYY-M-D 或 now |
| maxCheckbox[int] | validate[maxCheckbox[2]] | 最多选取的项目数（用于Checkbox） |
| minCheckbox | validate[minCheckbox[2]] | 最少选取的项目数（用于Checkbox） |
| equals | validate[equals[id]] | 当前控件值需与 id 这个控件的值相同 |
| phone | validate[custom[phone]] | 验证电话号码 |
| validate[custom[email]] | 验证 Email 地址 | |
| integer | validate[custom[integer]] | 验证整数 |
| number | validate[custom[number]] | 验证数字 |
| date | validate[custom[date]] | 验证日期，格式为 YYYY/MM/DD、YYYY/M/D、YYYY-MM-DD、YYYY-M-D |
| dateFormat | validate[custom[dateFormat]] | 验证日期格式，格式为 YYYY/MM/DD、YYYY/M/D、YYYY-MM-DD、YYYY-M-D |
| dateTimeFormat | validate[custom[dateTimeFormat]] | 验证日期及时间格式，格式为：YYYY/MM/DD hh:mm:ss AM|PM |
| ipv4 | validate[custom[ipv4]] | 验证 ipv4 地址 |
| url | validate[custom[url]] | 验证 url 地址，需以 http://、https:// 或 ftp:// 开头 |
| onlyNumberSp | validate[custom[onlyNumberSp]] | 只接受填数字和空格 |
| onlyLetterSp | validate[custom[onlyLetterSp]] | 只接受填英文字母（大小写）和单引号(‘) |
| onlyLetterNumber | validate[custom[onlyLetterNumber]] | 只接受数字和英文字母 |
| ajax | validate[ajax[ajaxUserCallPhp]] | 在验证规则中自定义
“ajaxUserCallPhp”:{ “url”:”phpajax/ajaxValidateFieldUser.php”, “extraData”:”name=eric”, “alertTextOk”:”* 此帐号名称可以使用”, “alertText”:”* 此名称已被其他人使用”, “alertTextLoad”:”* 正在确认帐号名称是否有其他人使用，请稍等。” } |
| funcCall | validate[funcCall[functionName]] | 调用外部函数 |
【API 方法】
| 名称 | 示例 | 说明 |
|---|---|---|
| attach | $(“#form_id”).validationEngine(“attach”); | 注册表单验证事件 |
| detach | $(“#form_id”).validationEngine(“detach”); | 取消注册表单验证事件 |
| validate | alert($(“#form_id”).validationEngine(“validate”)); | 验证表单，返回结果 true 或 false |
| validateField | alert($(“#form_id”).validationEngine(“validateField”,”#element_id”)); | 验证单个控件，返回结果 true 或 false |
| showPrompt | $(“#element_id”).validationEngine(“showPrompt”,”提示内容”,”load”); | 在该元素上创建一个提示内容，3 种状态：”pass”, “error”, “load” |
| hidePrompt | $(“#element_id”).validationEngine(“hidePrompt”); | 隐藏该元素的提示内容 |
| hide | $(“#form_id”).validationEngine(“hide”); | 关闭表单中的提示 |
| hideAll | $(“#form_id”).validationEngine(“hideAll”); | 关闭页面上的所有提示 |
| updatePromptsPosition | $(“#form_id”).validationEngine(“updatePromptsPosition”) | 更新提示层的位置 |
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/186200.html原文链接：https://javaforall.net
