主要面向移动端的表单验证插件,能快速方便的验证表单和单个输入控件,支持基本的验证规则。支持 jQuery 和 Zepto。
<link rel="stylesheet" href="cxvalidation.css">
<script src="zepto.js"></script>
<script src="cxvalidation.js"></script>
// 结果返回 true 或 false
// JavaScript
cxValidation(document.getElementById('input_id'));
cxValidation(document.getElementById('form_id'));
// jQuery or Zepto
$.cxValidation($('#input_id'));
$.cxValidation($('#form_id'));
// 绑定表单的提交事件,验证失败会有提示,验证通过后才会提交
// JavaScript
cxValidation.attach(document.getElementById('form_id'));
// jQuery or Zepto
$.cxValidation.attach($('#form_id'));
var options = {
complete: function(result) {
console.log('验证完成', result);
},
success: function(result) {
console.log('验证通过', result);
},
error: function(result) {
console.log('验证失败', result);
}
};
// 简易方法,快速设置验证成功及失败的回调
cxValidation(document.getElementById('input_id'), options.success, options.error);
cxValidation(document.getElementById('form_id'), options.success, options.error);
cxValidation.attach(document.getElementById('form_id'), options.success, options.error);
// 完整方法,可设置验证完成、成功及失败的回调
cxValidation(document.getElementById('input_id'), options);
cxValidation(document.getElementById('form_id'), options);
cxValidation.attach(document.getElementById('form_id'), options);
名称 | 默认值 | 说明 |
---|---|---|
complete | undefined | 验证完成时调用的方法 |
success | undefined | 验证通过时调用的方法 |
error | undefined | 验证失败时调用的方法 |
名称 | 类型 | 说明 |
---|---|---|
status | boolean | 验证结果 |
message | string | 提示消息 |
rule | string | 验证未通过的的规则名称 |
element | DOM Element | 验证未通过的元素 |
验证规则放置在input
的data-validation
属性中,如使用多个规则,用,
分割
<input data-validation="required">
<input data-validation="required,integer">
<input data-validation="required,integer,min[3]">
名称 | 说明 |
---|---|
required | 必填、必选 |
groupRequired[name][min] | 群组必填
name: 群组名称 min: 最少填写/选择数量,默认值为 1 |
condRequired[id] | 依赖必填
id: 控件 id(如依赖多个输入控件,用英文逗号分隔) |
equals[id] | 相等验证
id: 控件 id |
minSize[int] | 最少字符数限制 |
maxSize[int] | 最多字符数限制 |
min[int] | 最小数值限制 |
max[int] | 最大数值限制 |
integer | 验证整数 |
number | 验证数值(正负数、浮点数) |
onlyNumber | 只能填写数字 |
onlyNumberSp | 只能填写数字和空格 |
onlyLetterSp | 只能填写英文字母和空格 |
onlyLetterNumber | 只能填写英文字母和数字 |
onlyLetterNumberSp | 只能填写英文字母、数字、空格 |
验证电子邮件地址 | |
phone | 验证电话号码 |
url | 验证网址 |
chinese | 只能填写中文汉字 |
chinaId | 验证身份证号码(仅支持 18 位) |
chinaIdLoose | 验证身份证号码(兼容 18 和 15 位) |
chinaZip | 验证邮政编码 |
验证 QQ 号码 | |
call[functionName] | 调用外部函数验证 |
<input data-validation="required" data-validation-message="该项为必填">
名称 | 说明 |
---|---|
validation | 验证规则 |
validation-message | 验证提示消息,可统一设置提示信息,也可以根据验证规则进行提示,详见[Demo] |
名称 | 示例 | 说明 |
---|---|---|
attach | cxValidation.attach(document.getElementById('form_id'), options) | 绑定表单验证 |
detach | cxValidation.detach(document.getElementById('form_id')) | 解除表单验证 |