用途:Regle 是面向 Vue 3 的 headless 表单校验库,采用类型安全、基于模型的设计,提供完整 TypeScript 推断,可配合任意 UI 框架或设计系统使用。需要 Vue 3.3+ 与 TypeScript 5.1+。
主要能力:通过 useRegle 声明状态与规则,返回响应式 r$ 对象,包含字段值、错误、脏状态与校验方法(如 $invalid、$dirty、$errors、$pending、$validate、$touch、$reset)。规则默认全部可选,需加 required 才强制字段。支持自定义消息、getErrors、flatErrors 展示错误,以及 autoDirty、lazy、silent、rewardEarly、disabled、validationGroups 和按字段修饰符。
使用方式:安装核心与内置规则 pnpm add @regle/core @regle/rules;可选 schema 支持 pnpm add @regle/schemas(Zod、Valibot、ArkType)。useRegle 第一个参数为状态(原始对象、reactive、ref 或单值),第二个参数为与数据结构对应的规则对象;模板中用 v-model 绑定 r$.$value.字段名,遍历 r$.$errors.字段名显示错误,按钮调用 r$.$validate() 提交。
MCP:提供 MCP 服务器,可用于获取文档与补全,配置为 {"mcpServers":{"regle":{"command":"npx","args":["@regle/mcp-server"]}}}。
相关技能:regle-rules 覆盖内置规则、createRule 自定义规则、withMessage/withParams/withAsync 包装器与 and/or/applyIf/assignIf 操作符;regle-advanced 覆盖集合、异步、服务端错误、重置、作用域校验、变体与全局配置;regle-schemas 覆盖 Zod、Valibot、ArkType 与 Standard Schema 集成;regle-typescript 覆盖类型安全输出与规则 schema、组件 props 的类型标注。
限制:资料未提供收费、价格、平台支持范围、性能数据或具体效果说明。