@gravity-ui/dynamic-forms

中文文档
6.1.0发布于 2026/11/17MITTypeScriptESM + CJS近 30 天下载 2.4万

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

中文使用文档
文档目录7 节
  1. 安装
  2. 目录
  3. 这是什么
  4. 如何运作
  5. 依赖关系
  6. 编号 18N
  7. 发展

@重力- ui/ 动力- 形式 npm package CI storybook

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

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 切入点移动到包根. 见 移徙指南 实现全面过渡和 文件/已折旧 用于先前的 API 文档.

安装

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

目录

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

这是什么

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 函数 :

// index.js

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

configure({lang: Lang.Ru});

发展

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

npm ci
npm run dev

版本与发布记录

@gravity-ui/dynamic-forms 共发布 139 个版本,首次发布于 2023/03/14;过去 12 个月发布了 45 个版本。

版本发布日期距今
6.1.0latest2026/11/17今天
5.40.0untagged2026/11/17今天
5.39.02026/11/161 天前
5.38.12026/11/107 天前
6.0.02026/11/107 天前
5.38.02026/10/2325 天前

其他发布通道:beta → 5.0.0-beta.0,untagged → 5.40.0。

关于 @gravity-ui/dynamic-forms 的常见问题

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