# Test 规则校验
uv-ui内置了一些校验规则,如是否手机号,邮箱号,URL等
这些规则方法,挂载在$uv.test
下面,如验证是否手机号:$uv.test.mobile('13888889999')
,如果验证通过,返回true
,否则返回false
# 按需引入
如果未做全局扩展配置 (opens new window),可以按需引入:
// 引入,实例中未写完,自己根据需求写
import { code, array, jsonString, object, email } from '@/uni_modules/uv-ui-tools/libs/function/test.js';
# code(value, len = 6)
校验是否验证码(要求为数字),返回true
或者false
。
value
<String> 验证码字符串len
<Number> 验证码长度,默认为6
console.log(uni.$uv.test.code('4567', 4));
# array(array)
校验是否数组,返回true
或者false
。
array
<Array> 数组
console.log(uni.$uv.test.array([1, 2, 3]));
# jsonString(json)
校验是否是Json字符串,返回true
或者false
。
json
<Json> Json字符串
注意:请留意json字符串的要求:
- 整体为一个字符串
- 字符串对象内的属性需要用
""
双引号包含
console.log(uni.$uv.test.jsonString('{"a": 1}'));
# object(object)
校验是否是是对象,返回true
或者false
。
object
<Object> 对象
console.log(uni.$uv.test.object({a: 1}));
# email(email)
校验是否邮箱号,返回true
或者false
。
email
<String> 字符串
console.log(uni.$uv.test.email('123465798@gmail.com'));
# mobile(mobile)
校验是否手机号,返回true
或者false
。
mobile
<String> 字符串
console.log(uni.$uv.test.mobile('13845678900'));
# url(url)
校验是否URL链接,返回true
或者false
。
url
<String> 字符串
console.log(uni.$uv.test.url('http://www.uv-uiui.com'));
# empty(value)
校验值是否为空,返回true
或者false
。
此方法等同于empty
名称,但是为了更语义化,推荐用empty
名称。
这里指的“空”,包含如下几种情况:
值为
undefined
(一种类型),非字符串"undefined"
字符串长度为0,也即空字符串
值为
false
(布尔类型),非字符串"false"
值为数值
0
(非字符串"0"
),或者NaN
值为
null
,空对象{}
,或者长度为0的数组value
<any> 字符串
console.log(uni.$uv.test.empty(''));
# date(date)
效验是否普通日期
验证一个字符串是否日期,返回true
或者false
,如下行为正确:
2020-02-10
、2020-02-10 08:32:10
、2020/02/10 3:10
、2020/02/10 03:10
、2020/02-10 3:10
如下为错误:
2020年02月10日
、2020-02-10 25:32
总的来说,年月日之间可以用"/"或者"-"分隔(不能用中文分隔),时分秒之间用":"分隔,数值不能超出范围,如月份不能为13,则检验成功,否则失败。
date
<String> 日期字符串
console.log(uni.$uv.test.date('2020-02-10 08:32:10'));
# number(number)
效验是否十进制数值,整数,小数,负数,带千分位数(2,359.08)等可以检验通过,返回true
或者false
。
number
<String> 数字
console.log(uni.$uv.test.number('2020'));
# digits(number)
效验是否整数,所有字符都在0-9
之间,才校验通过,结果返回true
或者false
。
number
<String> 数字
console.log(uni.$uv.test.digits('2020'));
# idCard(idCard)
效验是否身份证号,包括尾数为"X"的类型,可以校验通过,结果返回true
或者false
。
idCard
<String> 身份证号
console.log(uni.$uv.test.idCard('110101199003070134'));
# carNo(carNo)
校验旧车牌号和新能源类型车牌号,结果返回true
或者false
。
carNo
<String> 车牌号
console.log(uni.$uv.test.carNo('京A88888'));
# amount(amount)
效验是否金额,最多两位小数,可以带千分位,结果返回true
或者false
。
amount
<String> 金额字符串
console.log(uni.$uv.test.amount('3,233.08'));
# chinese(zh)
效验是否汉字,可以为单个汉字,或者汉字组成的字符串,结果返回true
或者false
。
zh
<String> 中文字符串
console.log(uni.$uv.test.chinese('更上一层楼'));
# letter(en)
效验是否字母,只能为"a-z"或者"A-Z"之间的字符,结果返回true
或者false
。
en
<String> 字母串
console.log(uni.$uv.test.letter('uv-ui'));
# enOrNum(str)
效验是否字母或者数字,只能是字母或者数字,结果返回true
或者false
。
str
<String> 字母或者数字字符串
console.log(uni.$uv.test.enOrNum('uv-ui'));
# contains(str, subStr)
效验是否包含某个值,字符串中是否包含某一个子字符串,区分大小写,结果返回true
或者false
。
str
<String> 字符串subStr
<String> 子字符串
console.log(uni.$uv.test.contains('uv-ui', 'View'));
# range(number, range)
效验数值是否在某个范围内,如30在"29-35"这个范围内,不在"25-28"这个范围内,结果返回true
或者false
。
number
<Number> 数值range
<Array> 如"[25-35]"
console.log(uni.$uv.test.range(35, [30, 34]));
# rangeLength(str, range)
效验字符串长度是否在某个范围内,如"abc"长度为3,范围在"2-5"这个区间,结果返回true
或者false
。
str
<String> 数值range
<Array> 如"[25, 35]"
console.log(uni.$uv.test.rangeLength('abc', [3, 10]));