# @formhaus/core 中文文档

规范地址：https://npmcn.com/package/%40formhaus/core/

版本：1\.12\.1
npm 元数据更新时间：2026-11-02T20:10:42.438Z
中文译文更新时间：2026-11-15T08:53:23.445Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40formhaus/core
原文对照：https://npmcn.com/package/%40formhaus/core/?lang=original
项目主页：https://formhaus.dev/
源码仓库：https://github.com/formhaus-dev/formhaus

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.9 MB，168 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12
- 运行依赖：0 个
- 首次发布：2026-04-07T02:15:15.429Z
- 最新版本发布：2026-11-02T20:10:42.105Z
- 近 30 天下载量：13167（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：62（近 12 个月 62 个）

## 中文简介

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

## 安装

```sh
npm install @formhaus/core
```

也可以使用：`pnpm add @formhaus/core`、`yarn add @formhaus/core`、`bun add @formhaus/core`

## README

# @ formaus/ 核心

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

## 安装

```bash
npm install @formhaus/core
```

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

## 使用量

```ts
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', 'jane@example.com');
engine.getSubmitValues();
// { name: 'Jane', email: 'jane@example.com' }
```

## 入境点

| 导入 | 目录 |
| --- | --- |
| `@formhaus/core` | `FormEngine`, (中文(简体) ), `checkDefinition()`,类型 |
| `@formhaus/core/server` | `validateSubmission()` 对无信任的有效载荷,也作为 `server.iife.js` |
| `@formhaus/core/cloud` | 客户端 [福尔豪斯云](https://formhaus.dev/cloud/overview)数字 : `fetchForm()`, (中文(简体) ), `createSubmitter()`, (中文(简体) ), `createChallengeFrame()` |
| `@formhaus/core/i18n` | 信件和标签目录、 覆盖、 翻译密钥 |
| `@formhaus/core/fix` | `suggestFixes()`, (中文(简体) ), `applyFix()`, (中文(简体) ), `fixAll()` |
| `@formhaus/core/fields` | 自定义字段组件的助手 : `fieldState()`, (中文(简体) ), `scaleView()`, (中文(简体) ), `fromDate()`, (中文(简体) ), `toDate()` 和其他问题 |
| `@formhaus/core/research` | 选入调查特征: `research` 用于随机选项顺序 |
| `@formhaus/core/schema` | `schemaValidate()` 财务报告和审定财务报表 `schemaParse()` 用于 Zod, Valibot, ArkType 和其他标准 Schema 库 |
| `@formhaus/core/dirty` | `trackDirty()` 未保存的更改 |
| `@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` 条件、章节和 [可重复组](https://formhaus.dev/guide/groups)。见 [字段](https://formhaus.dev/guide/fields) 财务报告和审定财务报表 [验证](https://formhaus.dev/guide/validation)。 。 。 .
-   [多步骤形式](https://formhaus.dev/guide/steps) 使用生命周期钩,合成步骤验证和 [分支路线](https://formhaus.dev/guide/steps#route-between-branches)。 。 。 . `goToStep(id)` 打开一步 [URL 路径](https://formhaus.dev/recipes/steps-in-url):如果该步骤不能被打开,则表格打开之前可用的步骤并报告.
-   [服务器侧验证](https://formhaus.dev/guide/server-validation) 根据同一定义.
-   [形式活动](https://formhaus.dev/api/form-engine#form-events): 通过 `onFormEvent` 打电话 `start()` 获取 `form_viewed`, (中文(简体) ), `step_viewed`, (中文(简体) ), `field_shown`, (中文(简体) ), `form_submit_succeeded` 还有更多.
-   外观订阅 : `subscribe()`, (中文(简体) ), `subscribeField()`, (中文(简体) ), `subscribeStructure()` 财务报告和审定财务报表 `subscribeValues()`。 。 。 .
-   [翻译](https://formhaus.dev/guide/translations) 通过目录和覆盖文件.
-   定义检查和JSON补丁 [固定建议](https://formhaus.dev/api/form-engine) 结束 `checkDefinition()` 财务报告和审定财务报表 `@formhaus/core/fix`。 。 。 .
-   [福尔豪斯云](https://formhaus.dev/guide/endpoint):主机端点,提交,文件和bot检查. `FormhausForm` 内 `@formhaus/react/cloud` 财务报告和审定财务报表 `@formhaus/vue/cloud` 制作一个公布的表格.
-   [他们](https://formhaus.dev/guide/#optional-baseline-styles)数字 : `import '@formhaus/core/style.css'`,然后覆盖 `--fh-*` 自定义属性。 一个黑暗的主题 与 `data-fh-theme="dark"`。 。 。 .
-   [Claude 代码技能和 MCP 服务器](https://formhaus.dev/guide/mcp) 生成和检查定义.

## 文档

-   [指南](https://formhaus.dev/guide/), (中文(简体) ), [API 参考](https://formhaus.dev/api/form-engine) 财务报告和审定财务报表 [食谱](https://formhaus.dev/recipes/)
-   [框架概览](https://formhaus.dev/) 财务报告和审定财务报表 [游乐场](https://formhaus.dev/play)
-   [来源和问题](https://github.com/formhaus-dev/formhaus)

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。