专注JavaWeb开发 首页制式『默认式 OR 时间轴 网站地图|RSS订阅|设为首页|加入收藏
当前位置:首页 >前端 >jQuery > 正文

validationEngine中文版参数说明

来源: 博客园 作者: 紫寒1120 发布时间: 2015-04-21 浏览次数:

注意事项:

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文件进行合并

查看 Demo http://code.ciaoca.com/jquery/validation_engine/demo/demoForm.cn.html

修改版:jQuery Validation Engine v2.2.4 中文版

原 版:jQuery Validation Engine v2.2.4


【options 参数说明】(可选)

名称默认值说明
validationEventTrigger"blur"触发验证的事件,支持事件可参考 jQuery 的事件说明。

PS:如果希望只在表单提交时验证,可以设置为空。

scrolltrue屏幕自动滚动到第一个验证不通过的位置
focusFirstFieldtrue验证未通过时,是否给第一个不通过的控件获取焦点
promptPosition"topRight"验证提示信息的位置,可设置为:"topRight", "bottomLeft", "centerRight", "bottomRight"
autoPositionUpdatefalse是否自动调整提示层的位置
bindMethod"bind"验证事件的绑定方式,可设置为:bind, live

PS:设置 live 似乎绑定事件无效,但是表单提交时能验证,建议不修改。[Demo]

bindedfalse是否已经绑定其他事件,设为 true 将不进行验证。
inlineAjaxfalse
ajaxFormValidationfalse使用 Ajax 验证表单
ajaxFormValidationURLfalse设置 Ajax 验证的 URL,默认使用 form 的 action 属性
ajaxValidCache{}
onAjaxFormComplete$.noop表单提交,Ajax 验证完成后的行为(Function)[Demo]
onBeforeAjaxFormValidation$.noop表单提交验证规则通过后,Ajax 验证之前的行为(Function)[Demo]
onValidationCompletefalse表单提交验证完成时的行为(Function)

可以得到两个参数:表单元素 和 验证结果(ture or false)[Demo]

onSuccessfalse实时验证所有项目都通过时,发生的行为(Function)[Demo]
onFailurefalse实时验证有未通过项目时,发生的行为(Function)[Demo]

PS:onSuccess 和 onFailure 在禁用实时验证时无效。例如 validationEventTrigger 设为空,或 bindMethod 设为 live

isOverflownfalse表单是否在溢出滚动的元素内(即外部元素设置了 overflow:scroll)

PS:设置为 ture 后,提示内容的插入位置将更改为在验证的控件之前插入;

  此时需要在控件外层再套一个元素,并设置 class="inputContainer"

overflownDIV""设置了溢出滚动的元素,格式为 jQuery 的选择器。
showArrowtrue
isErrorfalse
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 });

【验证类型】

-->
名称示例说明

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]]

验证电话号码

email

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")

更新提示层的位置


QQ群: 武汉地区(142173356)验证消息JavaWeb1024

网友共有【】评论,点击查看



x 微信关注我们 随时获取最新网站资讯