@formhaus/core

中文文档
1.12.1发布于 2026/11/03MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1.3万

JSON形成定义引擎:验证,有条件的能见度,多步和分行路线. 零依赖性,在React,Vue,斯维尔特或香草中工作.

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 入境点
  4. 网络
  5. 特征
  6. 文档
  7. 许可证

@ formaus/ 核心

JSON的无框架引擎形成定义:场态,验证,有条件的能见度,可重复组,多步导航和分路. 没有运行时间依赖性和UI. 部分 福伦豪斯。用于渲染、使用 @formhaus/react 或者说 @formhaus/vue。 。 。 .

安装

npm install @formhaus/core

要求节点22.12或更晚. 无害环境管理; require() 还行.

使用量

import { FormEngine, type FormDefinition } from '@formhaus/core';

const definition: FormDefinition = {
  id: 'contact',
  title: 'Contact Us',
  submit: { label: 'Send' },
  fields: [
    { key: 'name', type: 'text', label: 'Name', validation: { required: true } },
    { key: 'email', type: 'email', label: 'Email', validation: { required: true } },
  ],
};

const engine = new FormEngine(definition);

engine.setValue('name', 'Jane');
engine.validate();
// { email: 'This field is required' }

engine.setValue('email', '[email protected]');
engine.getSubmitValues();
// { name: 'Jane', email: '[email protected]' }

入境点

导入目录
@formhaus/coreFormEngine, (中文(简体) ), checkDefinition(),类型
@formhaus/core/servervalidateSubmission() 对无信任的有效载荷,也作为 server.iife.js
@formhaus/core/cloud客户端 福尔豪斯云数字 : fetchForm(), (中文(简体) ), createSubmitter(), (中文(简体) ), createChallengeFrame()
@formhaus/core/i18n信件和标签目录、 覆盖、 翻译密钥
@formhaus/core/fixsuggestFixes(), (中文(简体) ), applyFix(), (中文(简体) ), fixAll()
@formhaus/core/fields自定义字段组件的助手 : fieldState(), (中文(简体) ), scaleView(), (中文(简体) ), fromDate(), (中文(简体) ), toDate() 和其他问题
@formhaus/core/research选入调查特征: research 用于随机选项顺序
@formhaus/core/schemaschemaValidate() 财务报告和审定财务报表 schemaParse() 用于 Zod, Valibot, ArkType 和其他标准 Schema 库
@formhaus/core/dirtytrackDirty() 未保存的更改
@formhaus/core/style.css可选基线样式 --fh-* 主题符号
@formhaus/core/schema.json定义中的JSON Schema

@formhaus/core/internal 持有共享代码 @formhaus/react 财务报告和审定财务报表 @formhaus/vue。它不是一个公共API,并且没有模具保证:任何释放都可以改变它。 不要导入它.

网络

只有 /cloud 条目进行网络请求.

  • @formhaus/core/cloud 电话 https://api.formhaus.cc,或 apiBase 并装入一个挑战框 https://formhaus.cc。 。 。 .
  • 其它每个条目都不提出网络请求.

特征

  • 字段类型,验证规则, show 编号 : showAny 条件、章节和 可重复组。见 字段 财务报告和审定财务报表 验证。 。 。 .
  • 多步骤形式 使用生命周期钩,合成步骤验证和 分支路线。 。 。 . goToStep(id) 打开一步 URL 路径:如果该步骤不能被打开,则表格打开之前可用的步骤并报告.
  • 服务器侧验证 根据同一定义.
  • 形式活动: 通过 onFormEvent 打电话 start() 获取 form_viewed, (中文(简体) ), step_viewed, (中文(简体) ), field_shown, (中文(简体) ), form_submit_succeeded 还有更多.
  • 外观订阅 : subscribe(), (中文(简体) ), subscribeField(), (中文(简体) ), subscribeStructure() 财务报告和审定财务报表 subscribeValues()。 。 。 .
  • 翻译 通过目录和覆盖文件.
  • 定义检查和JSON补丁 固定建议 结束 checkDefinition() 财务报告和审定财务报表 @formhaus/core/fix。 。 。 .
  • 福尔豪斯云:主机端点,提交,文件和bot检查. FormhausForm 内 @formhaus/react/cloud 财务报告和审定财务报表 @formhaus/vue/cloud 制作一个公布的表格.
  • 他们数字 : import '@formhaus/core/style.css',然后覆盖 --fh-* 自定义属性。 一个黑暗的主题 与 data-fh-theme="dark"。 。 。 .
  • Claude 代码技能和 MCP 服务器 生成和检查定义.

文档

许可证

麻省理工学院

版本与发布记录

@formhaus/core 共发布 62 个版本,首次发布于 2026/04/07;过去 12 个月发布了 62 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.1latest2026/11/0313 天前
1.12.02026/11/0313 天前
1.11.02026/11/0213 天前
1.10.02026/11/0213 天前
1.9.02026/11/0213 天前
1.8.12026/10/3016 天前

关于 @formhaus/core 的常见问题

@formhaus/core 是什么?

JSON形成定义引擎:验证,有条件的能见度,多步和分行路线. 零依赖性,在React,Vue,斯维尔特或香草中工作.

如何安装 @formhaus/core?

在项目目录运行 npm install @formhaus/core,或使用 pnpm add / yarn add / bun add。

@formhaus/core 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@formhaus/core 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@formhaus/core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@formhaus/core 可以商用吗?

@formhaus/core 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@formhaus/core 的下载量有多少?

根据 npm 官方下载统计,@formhaus/core 在 2026/10/16 – 2026/11/14 这 30 天内被下载 13,167 次,日均约 439 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@formhaus/core 还在维护吗?

最新版本 1.12.1 发布于 2026/11/03(13 天前);至今共发布 62 个版本,其中过去 12 个月发布了 62 个;首次发布于 2026/04/07。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。