### 空值判断 #### required blur 必填，为空值会提示错误。空值指`''`、`undefined`、`null`。没有参数。 在值为空的情况下，如果没有使用`required`、`filled`或`notEmpty`这些必填规则，其他规则会自动通过。 ``` html ``` #### filled blur 必填，在`required`基础上，字符串不能全为空白（即调用`trim`方法）。没有参数。 例如输入多个空格，会提示错误。 ``` html ``` #### notEmpty input+blur 数组不能为空。字符串也可以比较。 ``` html 水杯 坚果 毛巾 沙发 ``` #### empty input+blur 必须为空。与`notEmpty`相反。字符串也可以比较。 ``` html 水杯 坚果 毛巾 沙发 ``` ### 范围判断 #### minLength(min: number) blur 不得少于指定的字符数。字符串、数组长度均可比较。 - `min`：最小长度 ``` html ``` #### maxLength(max: number) blur 不得超过指定的字符数。字符串、数组长度均可比较。 - `max`：最大长度 ``` html ``` #### rangeLength(min: number, max: number) blur 字符数必须在指定的范围内。字符、数组长度均可比较。 - `min`：最小长度 - `max`：最大长度 ``` html ``` #### min(min: any) blur 不得小于指定的值。数字、字符串、日期比较均可。 - `min`：最小值 ``` html ``` #### max(max: any) blur 不得大于指定的值。数字、字符串、日期比较均可。 - `max`：最大值 ``` html ``` #### range(min: any, max: any) blur 不得大于指定的值。数字、字符串、日期比较均可。 - `min`：最小值 - `max`：最大值 ``` html ``` ### 自定义 #### pattern(re: RegExp) input+blur 根据正则表达式来判断。 - `re`：正则表达式 ``` html ``` ### 相等或包含判断 #### is(arg: any) blur 必须与参数相同，使用`===`比较。 - `arg`：用于判断的值 ``` html ``` ``` html ``` #### isNot(arg: any) blur 必须与参数不同，使用`===`比较。 - `arg`：用于判断的值 ``` html ``` ``` html ``` #### equals(arg: any) blur 必须与参数相等，除了数值，也可以比较数组和对象，使用的是[lodash.isEqual](https://www.lodashjs.com/docs/latest#_isequalvalue-other)。 - `arg`：用于判断的值 ``` html ``` ``` html 水杯 坚果 毛巾 沙发 ``` #### notEquals(arg: any) blur 必须与参数不等，除了数值，也可以比较数组和对象，使用的是[lodash.isEqual](https://www.lodashjs.com/docs/latest#_isequalvalue-other)。 - `arg`：用于判断的值 ``` html ``` ``` html 水杯 坚果 毛巾 沙发 ``` #### confirmed(arg: any) blur 验证逻辑与`equals`相同，错误信息专用于密码的二次确认。 ``` vue ``` #### includes(arr: any[]) input+blur 验证值为数组，必须包含参数中的项。 ``` html 水杯 坚果 毛巾 沙发 ``` #### excludes(arr: any[]) input+blur 验证值为数组，不能包含参数中的项。 ``` html 水杯 坚果 毛巾 沙发 ``` #### included(arr: any[]) input+blur 必须为参数中的某一个值。 ``` html 水杯 坚果 毛巾 沙发 ``` #### excluded(arr: any[]) input+blur 不能为参数中的任一个值。 ``` html 水杯 坚果 毛巾 沙发 ``` #### unique(arr: any[]) blur 验证逻辑与`excluded`相同，错误信息专用于判断是否重复。 ``` vue ``` #### noDuplicates(arg: any[]) input 接受一个数组作为参数，验证数组中是否存在重复项。 ``` html 水杯 咖啡 水杯 咖啡 毛巾 ``` ### 类型判断 #### string input+blur 必须为字符串类型。 ``` html 字符串 数字 数组 ``` #### number input+blur 必须为数字类型。 使用`v-model`时，注意加入`.number`修饰符。 例如`'12'`会报错。 ``` vue ``` #### numeric(noSymbols?: boolean) input+blur 必须为数字。与`number`规则不同的是，它不关心是否为 string 或 number 类型，只要为数字即可。 例如`12`和`'12'`均可。 - `noSymbols`：如果为`true`，则不能包含如`+`、`-`、`.`这样的符号 ``` vue ``` #### integer input+blur 必须为整数。不关心是否为 string 或 number 类型。 ``` html ``` #### decimal(force?: boolean, digits?: string) blur 整数或小数。不关心是否为 string 或 number 类型。 - `force`：是否只允许小数 - `digits`：小数位数范围，格式如`1,3`。默认为`1,` ``` html ``` #### boolean input+blur 必须为布尔类型。 ``` html 字符串 true 数字 ``` #### function input+blur 必须为函数。 ``` html 字符串 对象 函数 ``` #### object input+blur 必须为对象。 ``` html 字符串 对象 数组 ``` #### plainObject input+blur 必须为简单对象。 ``` html 字符串 简单对象 日期 数组 ``` ### 字母、数字、中划线、下划线判断 #### alpha 是否只能为字母（a-zA-Z）。 ``` html ``` #### alphaNum 是否只能为字母或数字（a-zA-Z0-9）。 ``` html ``` #### alphaDash input+blur 必须由字母或下划线组成。 ``` html ``` #### alphaNumDash input+blur 必须由字母、数字或下划线组成。 ``` html ``` #### alphaSpaces input+blur 必须由字母或空格组成。 ``` html ``` #### lowerCase input+blur 不能出现大写字母。 ``` html ``` #### upperCase input+blur 不能出现小写字母。 ``` html ``` #### ^az input+blur 以小写字母开头。 ``` html ``` #### ^az09 input+blur 以小写字母或数字开头。 ``` html ``` #### ^az09_ input+blur 以小写字母、数字或下划线开头。 ``` html ``` #### ^azAZ input+blur 以字母开头。 ``` html ``` #### ^azAZ09 input+blur 以字母或数字开头。 ``` html ``` #### ^azAZ09_ input+blur 以字母、数字或下划线开头。 ``` html ``` #### az09$ blur 以小写字母或数字结尾。 ``` html ``` #### azAZ09$ blur 以字母或数字结尾。 ``` html ``` #### ^09$ input+blur 以数字组成。 ``` html ``` #### ^az09$ input+blur 以小写字母或数字组成。 ``` html ``` #### ^az09-$ input+blur 以小写字母、数字或中划线组成。 ``` html ``` #### ^az09-.$ input+blur 以小写字母、数字、"-"或"."组成。 ``` html ``` #### ^azAZ09$ input+blur 以字母或数字组成。 ``` html ``` #### ^azAZ09-$ input+blur 以字母、数字或"_"组成。 ``` html ``` #### ^azAZ09_$ input+blur 以字母、数字或"_"组成。 ``` html ``` #### ^azAZ09-_$ input+blur 以字母、数字、"-"或"_"组成。 ``` html ``` #### without-- input+blur 不能连续出现中划线。 ``` html ``` #### without__ input+blur 不能连续出现下划线。 ``` html ``` ### 特定场景判断 #### email blur 必须为正确的邮箱。 ``` html ``` #### ip blur 必须为正确的 IP。 ``` html ``` #### port blur 必须为正确的端口。 ``` html ``` #### halfWidth input+blur 需要输入半角字符。 ``` html ``` #### fullWidth input+blur 必须输入全角字符。 ``` html ``` #### macAddress input+blur 必须输入正确的 MAC 地址。 ``` html ``` #### ascii input+blur 必须输入 ascii 字符。 ``` html ``` #### base64 blur 必须输入 base64 编码。 ``` html ``` #### byteLength(min: number, max: number) input+blur 输入字符串的字节长度范围限制。 - `min`：最小字节长度 - `max`：最大字节长度 ``` html ``` #### dataURI blur 必须输入 dataURI 编码。 ``` html ``` #### divisibleBy(divisor: number) blur 输入数字能否被相应除数整除。 - `divisor`：除数 ``` html ``` #### hash(algorithm: string) blur 输入编码是否符合指定哈希算法。 - `algorithm`：算法名称，支持`md4`、`md5`、`sha1`、`sha256`、`sha384`、`sha512`、`ripemd128`、`ripemd160`、`tiger128`、`tiger160`、`tiger192`、`crc32`以及`crc32b` ``` html ``` #### md5 blur 输入编码是否符合md5算法。 ``` html ``` #### hex blur 输入数字是否是十六进制。 ``` html ``` #### hexColor blur 输入字符串是否是十六进制颜色码。 ``` html ``` #### creditCard blur 输入信用卡号码是否合法。 ``` html ``` #### fqdn blur 输入全限定域名是否合法。 ``` html ``` #### ipOrFQDN blur 输入内容是否为一个合法IP或全限定域名。 ``` html ``` #### isbn(version: number) blur 输入内容是否为一个合法的国际标准书号(ISBN)。 - `version`：ISBN版本，接受`10`或`13` ``` html ``` #### issn blur 输入内容是否为一个合法的国际标准连续出版物号(ISSN)。 ``` html ``` #### isin blur 输入内容是否为一个合法的国际证券识别码(ISIN)。 ``` html ``` #### iso8601(strict: boolean) blur 输入内容是否为合法的ISO8601日期。 - `strict`: 是否检测闰年日期。如果`strict`的值为`true`，则`2019-02-29`这样的日期属于非法日期 ``` html ``` #### iso31661Alpha2 blur 输入内容是否为合法的ISO 3166-1 Alpha-2国家代码。 ``` html ``` #### iso31661Alpha3 blur 输入内容是否为合法的ISO 3166-1 Alpha-3国家代码。 ``` html ``` #### json input+blur 输入字符串是否可以被解析为JSON格式。 ``` html ``` #### jwt blur 输入字符串是否为合法的JSON Web Token。 ``` html ``` #### latLong blur 输入字符串是否为合法的经纬度坐标。 ``` html ``` #### mobile (locale?: any[], strict?: boolean) blur 输入内容是否为合法的手机号。 - `locale`：所在地区，例如`zh-CN`、`ja-JP`等。可以是一个字符串或数组。如果不填，则尝试自动匹配所有地区。 - `strict`：是否检验国家代号。如果为`true`，则必须以`+`和国家代码开头。 ``` html ``` #### mongoId blur 输入字符串是否为合法的MongoDB对象ID。 ``` html ``` #### postalCode(locale: string) blur 输入字符串是否为合法的邮政编码。 - `locale`：所在地区。例如`CH`、`JP`等。 ``` html ``` #### uuid(version?: number) blur 输入字符串是否为合法的UUID。 - `version`：采用的UUID版本。接受`3`、`4`和`5`。如果不填，则尝试自动匹配所有版本。 ``` html ``` #### chinese input+blur 输入字符串是否为合法的中文内容。 ``` html ```