- 第2版前言
- 本书结构
- 读者对象
- 本书约定
- 读者反馈&示例下载
- 疑难解答&本书勘误
- 第1章 认识 jQuery
- 第2章 jQuery 选择器
- 第3章 jQuery 中的 DOM 操作
- 第4章 jQuery 中的事件和动画
- 第5章 jQuery 对表单、表格的操作及更多应用
- 第6章 jQuery 与 Ajax 的应用
- 第7章 jQuery 插件的使用和写法
- 第8章 用 jQuery 打造个性网站
- 第9章 jQuery Mobile
- 第10章 jQuery 各个版本的变化
- 第11章 jQuery 性能优化和技巧
- 附录A 关于 $(document).ready() 函数
- 附录B Firebug
- 附录C Ajax 的 XMLHttpRequest 对象的属性和方法
- 附录D jQuery $.ajax() 方法的参数详解
- 附录E jQuery 加载并解析 XML
- 附录F 插件 API
- 附录G jQuery 速查表
F.1 Validation 插件 API
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 | 增加一个验证规则,它代替了 |
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 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论