返回介绍

F.1 Validation 插件 API

发布于 2024-08-20 01:10:33 字数 9560 浏览 0 评论 0 收藏 0

Validation插件有两个经常被用到的选项,分别是方法(method)和规则(rule)。

(1)方法。验证方法就是通过执行验证逻辑判断一个元素是否合法。例如email()方法就是检查当前文本格式是否是正确的E-mail格式。读者能很方便地利用Validation插件提供的方法来完成验证。另外,读者也可以自定义方法。

(2)规则。验证规则将元素和元素的验证方法关联起来,例如验证一个需要E-mail格式和必填的属性name为email的元素,可以定义该元素的规则如下:

 插件方法如表F-1所示。

表F-1 插件方法

名 称

返回类型

说 明

validate(options)

Validator

验证被选择的form

valid()

Boolean

检查被选择的from或者被选择的所有元素是否有效

rules()

Options

为第1个被选择的元素返回验证规则

rules("add", rules)

Options

增加指定的验证规则并为第1个匹配元素返回所有的规则

rules("remove", rules)

Options

移除指定的验证规则并为第1个匹配元素返回所有的规则

removeAttrs(attributes)

Options

从第1个匹配元素中移除指定的属性并返回

 内置验证规则如表F-2所示。

表F-2 内置验证规则

名 称

返回类型

说 明

required()

Boolean

使元素总是必须的

required(dependency-expression)

Boolean

根据给定的表达式结果,判断元素是否是必须的

required(dependency-callback)

Boolean

根据给定的回调函数的返回值,判断元素是否是必须的

remote(url)

Boolean

使用请求资源检查元素的有效性

minlength(length)

Boolean

要求元素满足给定的最小长度规则

maxlength(length)

Boolean

要求元素满足给定的最大长度规则

rangelength(range)

Boolean

要求元素满足给定的长度范围规则

min(value)

Boolean

要求元素满足给定的最小值规则

max(value)

Boolean

要求元素满足给定的最大值规则

range(range)

Boolean

要求元素满足给定值的范围规则

email()

Boolean

要求元素满足E-mail格式规则

url()

Boolean

要求元素满足url格式规则

date()

Boolean

要求元素满足date格式规则

dateISO()

Boolean

要求元素满足ISO date格式规则

dateDE()

Boolean

要求元素满足german date格式规则

number()

Boolean

要求元素满足带小数点的数字格式规则

numberDE()

Boolean

要求元素满足german format并带小数点的数字格式规则

digits()

Boolean

要求元素满足整型格式规则

creditcard()

Boolean

要求元素满足信用卡号码格式规则

accept(extension)

Boolean

要求元素满足特定的文件格式

equalTo(other)

Boolean

要求元素等于另外一个元素

phoneUS()

Boolean

要求元素满足美国电话号码的格式规则

 Validator

Validation验证会返回一个Validator对象,validator对象可以帮助用户触发validation程序或者

改变form的内容。validator对象更多的方法如表F-3所示。

表F-3 validator对象的方法

名 称

返回类型

说 明

form()

Boolean

验证form,如果验证合法则返回true,否则返回false

element(element)

Boolean

验证一个元素,如果验证合法则返回true,否则返回false

resetForm()

undefined

复位被验证的form

showErrors(errors)

undefined

显不指定的提示信息

numberOfInvalids()

Integer

返回无效字段的个数

validator对象中的静态方法如表F-4所示。

表F-4 validator对象中的静态方法

名 称

返回类型

说 明

setDefaults(defaults)

undefined

修改validation初始的设置

addMethod(name, method, message)

undefined

增加一个新的validation方法。该方法必须由name(必须是一 个合法的JavaScript标识符)、一个基于函数的JavaScript和 一个默认的字符串提示信息组成

addClassRules(name, rules)

undefined

增加一个验证规则,它代替了rules中的验证

addClassRules(rules)

undefined

增加多个验证规则

 实用项

表F-5 实用项

名 称

返回类型

说 明

jQuery.validator.format(template, argument, argumentN…)

String

使用参数来替换{n}占位符

 普通选择器

表F-6 普通选择器

名 称

返回类型

说 明

:blank

Array<Element>

匹配值为空的元素

:filled

Array<Element>

匹配值不为空的元素

:unchecked

Array<Element>

匹配所有没被选择的元素

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。
列表为空,暂无数据
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文