更新记录

1.0.0（2026-11-05） 下载此版本

1.0.0

  • 首个版本，第 13 批插件。
  • 纯函数表单校验：一次返回全部错误，不绑任何 UI

平台兼容性

PlugKit 校验套件

纯函数表单校验：一次返回全部错误，不绑任何 UI

零 UI 依赖的校验规则引擎：内置 20+ 规则、中文错误模板、嵌套/数组路径、异步规则与自定义扩展，一次返回全部错误。

零第三方依赖 · 零系统权限 · 无需 uniCloud · 不联网、不采集、不上报。

5 分钟接入

  1. 把 uni_modules/pk-validator/ 拷进你的 uni-app 工程（或用 HBuilderX 从插件市场导入）。
  2. 在需要的地方引入：
import pk from '@/uni_modules/pk-validator/js_sdk/index.js'

pk.init(/* 可选配置 */)
const r = pk./* 方法 */()
  1. 完整可运行工程见 example/（导入即跑，每个公开方法都有演示按钮）。

API

方法 说明
check(value, rules) 单值校验，返回 { valid, errors }
validate(schema, data, opts) 全量同步校验，返回 { valid, errors, first, fields }
validateAsync(schema, data, opts) 支持异步规则（远程唯一性等），返回 Promise
addRule(name, fn, message) 注册自定义规则与默认消息
setMessages(map) / use(preset) 替换错误文案 / 加载规则预设
firstError(errors) / fieldErrors(errors, path) 结果便捷提取

自定义传输 / 注入点（演示与单测可用）

pk._reset() 清空自定义规则与消息（演示/单测用）。

错误码

码 含义
E-VL-01 schema 结构非法
E-VL-02 未知规则名
E-VL-03 异步规则执行失败
E-VL-04 路径解析失败
E-VL-05 校验被中止

竞品痛点 → 设计决策

痛点 本插件
校验器绑死 UI 组件，样式丑、换 UI 库就用不了 纯函数无状态，不 import 任何组件/CSS；返回数据，UI 完全交给接入方
一直返回 true，示例复制下来都不生效 validate() 固定返回 { valid, errors, first, fields }；valid 只在 errors 为空时为 true，且有单测锁死
自定义规则只校验一次 / 动态字段失效 每次 validate 独立无状态执行；支持 items[0].name 等数组与嵌套路径
文档混乱、属性失效 API 只有 6 个方法 + 一张规则表，全部有单测与演示页按钮
错误提示要自己一条条拼 内置中文消息模板 {{label}}/{{value}} 占位，支持 setMessages 全量替换

兼容性

见 docs/compatibility.md。纯逻辑 API 已通过 node 单测；真机项按 HBuilderX 云打包验证。

目录

pk-validator/
├── README.md / CHANGELOG.md
├── uni_modules/pk-validator/    # 发布包（package.json + js_sdk/）
├── example/             # 完整可导入 HBuilderX 工程 + 演示页
├── docs/                # 在线文档 HTML / listing.md / compatibility.md
└── tests/run.test.js    # node 单测（node tests/run.test.js）

隐私、权限声明

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

无

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

插件不采集任何数据

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

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。