更新记录

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 复核。
  • 本组件不含任何网络请求;如需服务端二次校验请在业务侧自行完成。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据。所有校验与格式化均在本机内存中完成,无网络请求、无 SDK、无第三方密钥。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。