# @ginkgo-bioworks/react-json-schema-form-builder 中文文档

规范地址：https://npmcn.com/package/%40ginkgo-bioworks/react-json-schema-form-builder/

版本：4\.2\.0
npm 元数据更新时间：2026-09-28T22:40:46.478Z
中文译文更新时间：2026-11-16T09:11:01.718Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ginkgo-bioworks/react-json-schema-form-builder
原文对照：https://npmcn.com/package/%40ginkgo-bioworks/react-json-schema-form-builder/?lang=original
项目主页：https://github.com/ginkgobioworks/react-json-schema-form-builder#readme
源码仓库：https://github.com/ginkgobioworks/react-json-schema-form-builder

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

- 包体积（解压后）：1.1 MB，10 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：3 个
- peer 依赖：react ^19\.0\.0，@mui/material ^7\.0\.0 \|\| ^9\.0\.0，@emotion/react ^11\.14\.0，@emotion/styled ^11\.14\.0，@mui/icons-material ^7\.0\.0 \|\| ^9\.0\.0
- 首次发布：2020-12-11T18:36:01.989Z
- 最新版本发布：2026-09-28T22:40:46.196Z
- 近 30 天下载量：31808（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：40（近 12 个月 3 个）

## 中文简介

视觉配置基于 JSON Schema 格式的反应组件

## 安装

```sh
npm install @ginkgo-bioworks/react-json-schema-form-builder
```

也可以使用：`pnpm add @ginkgo-bioworks/react-json-schema-form-builder`、`yarn add @ginkgo-bioworks/react-json-schema-form-builder`、`bun add @ginkgo-bioworks/react-json-schema-form-builder`

## README

# 反应 JSON Schema 窗体构建器

[![npm](https://img.shields.io/npm/v/@ginkgo-bioworks/react-json-schema-form-builder)](https://www.npmjs.com/package/@ginkgo-bioworks/react-json-schema-form-builder) [![CI](https://github.com/ginkgobioworks/react-json-schema-form-builder/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/ginkgobioworks/react-json-schema-form-builder/actions) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![GitHub issues](https://img.shields.io/github/issues-raw/ginkgobioworks/react-json-schema-form-builder)](https://github.com/ginkgobioworks/react-json-schema-form-builder/issues)

这个寄存器包含一个反应JS组件的代码,叫做: `FormBuilder` 允许用户视觉配置 [JSON Schema 编码格式](https://json-schema.org/) 通过拖放和编辑卡片元素。 这个工具的一个使用案例可以是用于构建一个允许用户创建和分发自己调查的应用程序. React JSON Schema Form Builder提供了组件,允许用户动态地构建这样的调查表格. Form Builder也是自定义的,可以收录由开发者建置调查创建应用指定的新形式元素(如专用的电子邮件地址或文件上传输入).

此组件被包在一个演示应用程序上,以显示该工具如何与代码编辑器和 [Mozilla的回放 JSON 计程器](https://github.com/rjsf-team/react-jsonschema-form) 以构建一种形式,并维持一个实时的,代码代表它.

表格构建器作为国家防范机制软件包提供 [这里](https://www.npmjs.com/package/@ginkgo-bioworks/react-json-schema-form-builder)。 。 。 .

在操作中查看窗体构建器 [这里](https://ginkgobioworks.github.io/react-json-schema-form-builder/)

可提供更广泛的文件 [这里](https://react-json-schema-form-builder.readthedocs.io/en/main/)

## 所需资源

-   反应 19+
-   节点.js 20+ (LTS)
-   材料UI(MUI) 7+

## 快速启动

```bash
npm i --save @ginkgo-bioworks/react-json-schema-form-builder @mui/material @emotion/react @emotion/styled
```

## 使用量

```jsx
import React, { useState } from 'react';
import { FormBuilder } from '@ginkgo-bioworks/react-json-schema-form-builder';

function Example() {
  const [schema, setSchema] = useState('{}');
  const [uischema, setUiSchema] = useState('{}');

  return (
    <FormBuilder
      schema={schema}
      uischema={uischema}
      onChange={(newSchema, newUiSchema) => {
        setSchema(newSchema);
        setUiSchema(newUiSchema);
      }}
    />
  );
}

export default Example;
```

关于更多使用实例,见 [用法文档页](https://react-json-schema-form-builder.readthedocs.io/en/latest/Usage/)

## 捐款

见 [贡献页](https://github.com/ginkgobioworks/react-json-schema-form-builder/blob/main/CONTRIBUTING.md) 用于提供改进表格构建器的信息.

## 许可证

版权 2020-2026 [银戈生物制品](https://www.ginkgobioworks.com/)(原始内容存档于2018-09-29). Inc. 许可证Apache 2.0.

## 常见问题

### @ginkgo-bioworks/react-json-schema-form-builder 是什么？

视觉配置基于 JSON Schema 格式的反应组件

### 如何安装 @ginkgo-bioworks/react-json-schema-form-builder？

在项目目录运行 npm install @ginkgo-bioworks/react-json-schema-form-builder，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、@mui/material（^7\.0\.0 \|\| ^9\.0\.0）、@emotion/react（^11\.14\.0）、@emotion/styled（^11\.14\.0）、@mui/icons-material（^7\.0\.0 \|\| ^9\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ginkgo-bioworks/react-json-schema-form-builder 支持 TypeScript 吗？

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

### @ginkgo-bioworks/react-json-schema-form-builder 支持 ESM 还是 CommonJS？

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

### @ginkgo-bioworks/react-json-schema-form-builder 需要什么版本的 Node\.js？

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

### @ginkgo-bioworks/react-json-schema-form-builder 可以商用吗？

@ginkgo-bioworks/react-json-schema-form-builder 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @ginkgo-bioworks/react-json-schema-form-builder 的下载量有多少？

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

### @ginkgo-bioworks/react-json-schema-form-builder 还在维护吗？

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

