# @gravity-ui/dynamic-forms 中文文档

规范地址：https://npmcn.com/package/%40gravity-ui/dynamic-forms/

版本：6\.1\.0
npm 元数据更新时间：2026-11-17T12:54:31.531Z
中文译文更新时间：2026-11-17T12:55:42.814Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gravity-ui/dynamic-forms
原文对照：https://npmcn.com/package/%40gravity-ui/dynamic-forms/?lang=original
项目主页：https://github.com/gravity-ui/dynamic-forms#readme
源码仓库：https://github.com/gravity-ui/dynamic-forms

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

- 包体积（解压后）：1.9 MB，2003 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：9 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，react-is ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^18\.0\.0 \|\| ^19\.0\.0，final-form ^4\.20\.2，react-window ^1\.8\.11，react-final-form ^6\.5\.3，@gravity-ui/uikit ^8\.0\.0，@hello-pangea/dnd ^18\.0\.1，react-virtualized-auto-sizer ^1\.0\.26
- 首次发布：2023-03-14T11:54:04.785Z
- 最新版本发布：2026-11-17T12:54:31.171Z
- 近 30 天下载量：23717（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：139（近 12 个月 45 个）

## 中文简介

**联合国** • 妇女 [Русский](https://npmcn.com/package/%40gravity-ui/dynamic-forms/README-ru.md)

## 安装

```sh
npm install @gravity-ui/dynamic-forms
```

也可以使用：`pnpm add @gravity-ui/dynamic-forms`、`yarn add @gravity-ui/dynamic-forms`、`bun add @gravity-ui/dynamic-forms`

## README

# @重力- ui/ 动力- 形式 [![npm package](https://img.shields.io/npm/v/@gravity-ui/dynamic-forms)](https://www.npmjs.com/package/@gravity-ui/dynamic-forms) [![CI](https://img.shields.io/github/actions/workflow/status/gravity-ui/dynamic-forms/.github/workflows/ci.yml?label=CI&logo=github)](https://github.com/gravity-ui/dynamic-forms/actions/workflows/ci.yml?query=branch:main) [![storybook](https://img.shields.io/badge/Storybook-deployed-ff4685)](https://preview.gravity-ui.com/dynamic-forms/)

**联合国** • 妇女 [Русский](https://npmcn.com/package/%40gravity-ui/dynamic-forms/README-ru.md)

JSON Schema顶部的造型器 `react-final-form`。一个单一的策略既描述了数值,又描述了如何给出数值:验证规则是标准 Draft-07关键词,一个节点的绘制是 `nodeParameters` 扩展名.

-   输入点 : `@gravity-ui/dynamic-forms`。 。 。 .
-   状态 : **稳定 API**。 。 。 .
-   两层: `core` (无头发动机)和 `kit` (已准备好的实体和布局 `@gravity-ui/uikit`) (中文(简体) ).

上一个动态字段/动态视频 API 可从 `@gravity-ui/dynamic-forms/deprecated`. SchemaRender 从清除的进口 `/unstable` 切入点移动到包根. 见 [移徙指南](https://npmcn.com/package/%40gravity-ui/dynamic-forms/MIGRATION.md) 实现全面过渡和 [文件/已折旧](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/deprecated) 用于先前的 API 文档.

## 安装

```shell
npm install --save-dev @gravity-ui/dynamic-forms
```

## 目录

-   [如何使用](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/how-to-use.md) - 快速开始 `name` 道具 模式 选什么.
-   [API 参考](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/api.md) - 部件、钩子、道具、常数、公用事业、, `kit` 出口、类型.
-   [司马](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/schema.md) —— 说 `nodeParameters`旗帜 说明 关键词, `stringNumber`, (中文(简体) ), `$ref`。 。 。 .
-   [运行时间](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/runtime.md) ——节点生命周期,价值强制,验证,错误,事件,补丁.
-   [阿标](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/kit.md) ——布局,实体目录,服务组件,样式.
-   [延长](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/extension.md) ——自定义实体,布局,验证器,配置,独立渲染器.
-   [移徙](https://npmcn.com/package/%40gravity-ui/dynamic-forms/MIGRATION.md) - 从上一个主要API或 `/unstable`,转换光谱,兼容性通过 `/deprecated`。 。 。 .
-   [洞穴和限制](https://npmcn.com/package/%40gravity-ui/dynamic-forms/docs/en/limitations.md) ——密码验证差异,限制和错误.

## 这是什么

`src/lib` 是一个窗体引擎,从一个单一的JSON Schema中构建窗体和值概览。 这个 `core` 层本身没有控制: 所渲染出的一切都来自配置 。 验证通过 `json-schema-library` (草案07)加上惯例 `stringNumber` 关键词 这个 `kit` 层提供了现成的注册:30个实体密钥,涵盖6个节点类型,7个版式密钥,服务组件 `useExpanded` 钩、 错误文本和 `specToJsonSchema` 从旧 Spec 格式转换器.

## 如何运作

1.  **斯克马与相克.** `useSchemaRenderer` 克隆 `schema` 并使用验证符在服务领域存储状态.
2.  **节点.** `SchemaRendererNode` 逐个指针取下司马,登记 a `final-form` 字段,选择 `entity` 财务报告和审定财务报表 `layout`。 。 。 .
3.  **变化.** 值编辑,通过 `validateFields`,仅触发服务字段验证器.
4.  **错误.** 校验器按名称将错误传播到 `srState.errors`;带已更改消息的节点重递.
5.  **势相相.** `useSchemaRendererTools` 修补计划并添加外部错误, 重新启动验证 .

## 依赖关系

| 软件包 | 作用 | 为什么 |
| :-- | :-- | :-- |
| `react` 编号 : `react-dom` 编号 : `react-is` | 端点 | 18,19 编译. |
| `final-form` 编号 : `react-final-form` | 端点 | 表格,字段,提交,订阅. |
| `@gravity-ui/uikit` | 端点 | 版本 8. Kit控件:文本输入,选择,复选框等. |
| `json-schema-library` | 运行时间 | 草案07验证和习俗 `stringNumber` 关键词. |
| `decimal.js` | 运行时间 | 数字比较和规模 `stringNumber` 财务报告和审定财务报表 `*_with_scale`。 。 。 . |
| `@gravity-ui/date-components`, (中文(简体) ), `date-utils` | 运行时间 | `DateInput` 财务报告和审定财务报表 `DateValue`。 。 。 . |
| `@gravity-ui/icons` | 运行时间 | `iconName` 在警告、标签、文本中. |
| `@gravity-ui/i18n` | 运行时间 | 出错文本本地化. |
| `@bem-react/classname`, (中文(简体) ), `lodash`, (中文(简体) ), `uuid` | 运行时间 | 班级,公用事业,钥匙. |
| 摩纳哥 | 外部 | 没有捆绑。 通过 `userContext.MonacoEditor`。 。 。 . |

## 编号 18N

某些组成部分包括两种语言的文本符号(名词和短语): `en` (默认)和 `ru`。要设置语言,请使用 `configure` 函数 :

```js
// index.js

import {configure, Lang} from '@gravity-ui/dynamic-forms';

configure({lang: Lang.Ru});
```

## 发展

用故事本启动开发服务器执行以下命令:

```shell
npm ci
npm run dev
```

## 常见问题

### @gravity-ui/dynamic-forms 是什么？

联合国 • 妇女 Русский

### 如何安装 @gravity-ui/dynamic-forms？

在项目目录运行 npm install @gravity-ui/dynamic-forms，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、react-is（^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^18\.0\.0 \|\| ^19\.0\.0）、final-form（^4\.20\.2）、react-final-form（^6\.5\.3）、@gravity-ui/uikit（^8\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gravity-ui/dynamic-forms 支持 TypeScript 吗？

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

### @gravity-ui/dynamic-forms 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gravity-ui/dynamic-forms 可以商用吗？

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

### @gravity-ui/dynamic-forms 的下载量有多少？

根据 npm 官方下载统计，@gravity-ui/dynamic-forms 在 2026/10/17 – 2026/11/15 这 30 天内被下载 23,717 次，日均约 791 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gravity-ui/dynamic-forms 还在维护吗？

最新版本 6\.1\.0 发布于 2026/11/17（今天）；至今共发布 139 个版本，其中过去 12 个月发布了 45 个；首次发布于 2023/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

