required - 必填

适用于 input、textarea、select 输入框。(checkbox 与 radio 请使用 checked 规则)
字段必填,则值不能为空。字段非必填,则值为空的时候直接验证通过
nice-validator 扩展了选择器 :filled,选择填写了的字段

规则描述示例
required字段必填required
required(ruleName)满足规则 ruleName 则字段必填required(isCompany)
required(jqSelector)满足 jqSelector 则字段必填 (v0.8.0+)required(#id:filled)、required(#id:checked)、required(#id:enabled)
required(from, class, count)在一组字段中至少填写一个或多个 (v0.8.0+)required(from, .contact)
required(not, value)字段必填,但是排除值为 value 的情况required(not, -1)

示例:字段必填

<input type="text" name="username" data-rule="required">
<select name="gender" data-rule="required">
    <option value="">select ...</option>
    <option value="1">Male</option>
    <option value="2">Female</option>
    <option value="3">Other</option>
</select>
<textarea name="content" data-rule="required"></textarea>

示例:只有在 A 字段填写过后,B 字段才必填

$('#form1').validator({
    fields: {
        A: 'required',
        B: 'required(#A:filled)'
    }
});

示例:如果满足 jQuery 选择器 "#isCompany:checked",则字段必填

$('#form1').validator({
    fields: {
        companyName: 'required(#isCompany:checked)'
    }
});

示例:如果满足规则 "isCompany",则字段必填

<form id="form1">
    <input type="checkbox" name="isCompany" id="isCompany">
    <input type="text" name="companyName">
</form>
$('#form1').validator({
    rules: {
        isCompany: function() {
            return $('#isCompany').prop('checked');
        }
    },
    fields: {
        companyName: 'required(isCompany)'
    }
});

示例:className 为 contact 的字段至少填写一个

<input class="contact" name="mobile" placeholder="手机号"
    data-rule="required(from, .contact); mobile"
    data-msg-required="请至少填写一种联系方式">

<input class="contact" name="tel" placeholder="电话"
    data-rule="required(from, .contact); tel">

<input class="contact" name="email" placeholder="邮箱"
    data-rule="required(from, .contact); email">

checked - 必选

注意:checkbox 和 radio 类型的输入框请使用 checked 规则(而不是 required)

规则描述
checked必选
checked(n)必选 n 项
checked(n~)至少选择 n 项
checked(~n)最多选择 n 项
checked(n1~n2)选择 n1 到 n2 项

示例:至少选择一项

<label><input type="radio" name="gender" value="1" data-rule="checked">男</label>
<label><input type="radio" name="gender" value="2">女</label>
<label><input type="radio" name="gender" value="0">保密</label>

match - 两个字段匹配和比较

match 可以用于比较两个字段值是否相同,或是否不同,或大小关系,也可以用于比较日期或者时间

规则描述
match(name)当前字段值必须和 name 字段的值匹配
match(eq, name)同上
match(neq, name)当前字段值必须和 name 字段值不同
match(lt, name)当前字段值必须小于 name 字段值
match(gt, name)当前字段值必须大于 name 字段值
match(lte, name)当前字段值必须小于等于 name 字段值
match(gte, name)当前字段值必须大于等于 name 字段值
match(gte, name, date)当前日期值必须大于等于 name 字段日期值
match(gte, name, datetime)当前时间值必须大于等于 name 字段时间值

示例:确认密码要与密码一致

<label>密码:</label>
<input name="pwd" data-rule="密码: required;password;">
<label>确认密码:</label>
<input name="confirmPwd" data-rule="确认密码: match(pwd);">

示例:结束日期必须大于开始日期

<label>开始日期:</label>
<input name="startDate" data-rule="开始日期: required;date;">
<label>结束日期:</label>
<input name="endDate" data-rule="结束日期: required;date;match(gt, startDate, date)">

remote - 远程验证

服务端验证并返回结果,URL 为必传参数,默认 POST 请求

规则描述
remote(URL)请求服务端验证
remote(get:URL)使用 GET 方式请求服务端验证
remote(URL, name1, #id2 ...)传递额外动态参数
remote(URL, foo=value1&bar=value2, name3 ...)传递额外固定参数 (v0.8.0+)
remote(URL, foo:name1, bar:#id2, name3 ...)代理参数名称(实际服务器接收的参数为 foo 和 bar)
remote(jsonpURL)跨域地址自动采用 JSONP 请求方式
remote(jsonp:URL)强制 JSONP 请求方式
remote(cors:post:URL)强制 CORS + POST 请求方式(v0.10.8+)

示例:跨域请求

// 强制 jsonp 请求
"remote(jsonp:/user/checkName)"
// 强制 CORS, 请求类型为 POST (0.10.8+)
"remote(cors:post:/user/checkName)"

服务端返回结果格式

  1. 直接返回字符串结果

    // 为空代表通过
    ""
    // 不为空则代表错误
    "名字已被占用"
  2. 返回 JSON 格式

    // 验证通过
    {"ok": "名字很棒"}
    // 验证不通过
    {"error": "名字已被占用"}
    
    // 结果在第二级 data
    {"status": 200, "data": {"error": "名字已被占用"}}

前端转换服务端返回的结果格式

示例:如果服务端返回格式无法更改,可以用 dataFilter 参数转换

/* 假设服务端返回结果为: {"status":600, "msg":"名字已被占用"}
 */
$('#form1').validator({
    dataFilter: function(data) {
        if (data.status === 200) return "";
        else return data.msg;
    },
    fields: {
        name: "required; length(4~12); remote(/user/check/name)"
    }
});

integer - 整数

整数或者整数范围

规则描述
integer整数
integer(+)正整数
integer(+0)正整数和零
integer(-)负整数
integer(-0)负整数和零

range - 数值范围

注意:只验证范围,不验证是整数或者浮点数

规则描述
range(n~)请填写不小于 n 的数
range(~n)请填写不大于 n 的数
range(n1~n2)请填写 n1 到 n2 的数
range(n1~n2, false)请填写 n1 到 n2 的数(不包含边界值)(v0.9.0+)

示例:输入 0 ~ 100 的整数

<input name="score" data-rule="required; integer[+0]; range[~100]">

length - 字符长度

如果传第二个参数 “true”,则全角字符(汉子)计算为两个字符

规则描述
length(n)请填写 n 个字符
length(n~)请至少填写 n 个字符
length(~n)请最多填写 n 个字符
length(n1~n2)请填写 n1 到 n2 个字符
length(n~, true)请至少填写 n 个字符(全角字符计算双字符)

示例

<!-- 密码为 6 到 16 位 -->
<input type="password" name="pwd" data-rule="required;length(6~16)">
<!-- 内容不超过 140 个字符 -->
<textarea name="content" data-rule="length(~140)"></textarea>

filter - 过滤字符

注意:只过滤字符,不验证

规则描述
filter过滤 <>`"' 和字符实体编码的字符
filter(RegExp)自定义过滤正则

示例

// 过滤非数字字符
"filter(\D)"
// 过滤非中文
"filter(^\u0391-\uFFE5)"

validate - 执行验证另一个字段

v0.8.0+ & 1.0-
注意:用于在当前字段验证的时候触发其他字段验证,对当前字段不起作用

示例:字段 B 验证通过后,触发验证字段 A

<input type="text" name="A" data-rule="required;">
<input type="text" name="B" data-rule="required; validate(A)">