更新记录
1.0.0(2026-11-16)
1.0.0 首发:12 类校验器 + 5 类格式化器 + 50 项自检,easycom 组件与 index.uts 导出。
平台兼容性
ValidKit · uni-app x 表单校验与数据格式化组件
零依赖、零网络、零平台 API 的表单校验内核 + easycom 输入组件。 所有逻辑在本机内存完成,不采集或上传任何数据。仅支持 uni-app x(HBuilderX 4.19+)。
一、组件用法(easycom,无需 import / 注册)
<validkit-field
v-model="phone"
label="手机号"
rule="required,mobile"
mask="mobile"
placeholder="请输入手机号"
@validate="onValidate"
/>
| 属性 | 说明 |
|---|---|
label |
字段标题 |
modelValue |
绑定值(v-model) |
rule |
逗号分隔的校验器:required,mobile,email,idcard,bankcard |
mask |
仅展示脱敏:mobile / idcard / bankcard(不改动绑定值) |
tip |
无错误时的提示文案 |
事件:@validate 回传 {ok, errors:[{name,message}]}。
二、纯逻辑调用(不依赖组件)
import { validators, formatters, validate, validateForm, firstError } from '@/uni_modules/validkit'
validators.idcard('11010519491231002X') // true(含 GB 11643 校验位)
validators.bankcard('4111 1111 1111 1111') // true(Luhn)
formatters.rmbUpper(1234567.89)
// 壹佰贰拾叁万肆仟伍佰陆拾柒元捌角玖分
formatters.mobileMask('***') // 138****8000
const r = validate('***', [
{ name: 'required', rule: 'required', message: '必填' },
{ name: 'mobile', rule: 'mobile', message: '手机号不合法' }
])
r.ok // true
12 类校验器
required · mobile · email · idcard(18 位校验位)· bankcard(Luhn)·
minLength(n) · maxLength(n) · length(a,b) · regex(re) · inSet(arr) ·
range(min,max) · passwordStrength(minLen,minKinds) · custom(fn)
5 类格式化器
thousands 千分位 · rmbUpper 人民币大写 · mobileMask · idcardMask · bankcardGroup
三、校验规则约定
- 除
required外,空值一律视为「跳过」,由required单独负责非空,避免一条空值同时报多个错。 - 自定义函数抛异常一律判
false,不让坏规则拖垮整表。 - 单值
validate与整表validateForm两级 API;firstError直接取首条文案。
四、自检
内核内置 50 项自检(含身份证校验位、Luhn、跨节人民币大写边界)。
node js_sdk/validkit/core.js # 需配合 selfTest() 调用
五、边界与不承诺
- 身份证校验位正确 ≠ 证件真实存在;只做格式与校验位校验,不联网核验。
- 银行卡 Luhn 通过 ≠ 卡有效或可用;只做数学校验。
- 手机号正则按中国大陆 11 位;其它国家/地区规则需自行用
custom扩展。 - 人民币大写按财务常用写法实现;极端金额(超 兆 位)请用
custom复核。 - 本组件不含任何网络请求;如需服务端二次校验请在业务侧自行完成。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 1
赞赏 0
下载 12768186
赞赏 1959
赞赏
京公网安备:11010802035340号