# @data-driven-forms/carbon-component-mapper 中文文档

规范地址：https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/

版本：4\.2\.4
npm 元数据更新时间：2026-11-04T09:02:16.362Z
中文译文更新时间：2026-11-11T12:46:15.839Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40data-driven-forms/carbon-component-mapper
原文对照：https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/?lang=original
项目主页：https://data-driven-forms.org/
源码仓库：https://github.com/data-driven-forms/react-forms

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

- 包体积（解压后）：259 kB，178 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：react ^17\.0\.2 \|\| ^18\.0\.0 \|\| ^19\.0\.0，react-dom ^17\.0\.2 \|\| ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2020-09-29T12:03:55.503Z
- 最新版本发布：2026-11-04T09:02:15.766Z
- 近 30 天下载量：3799（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：193（近 12 个月 21 个）

## 中文简介

用于Data Driven Forms的碳反应元件映射器.

## 安装

```sh
npm install @data-driven-forms/carbon-component-mapper
```

也可以使用：`pnpm add @data-driven-forms/carbon-component-mapper`、`yarn add @data-driven-forms/carbon-component-mapper`、`bun add @data-driven-forms/carbon-component-mapper`

## README

[![npm version](https://badge.fury.io/js/%40data-driven-forms%2Fcarbon-component-mapper.svg)](https://badge.fury.io/js/%40data-driven-forms%2Fcarbon-component-mapper) [![Tweet](https://img.shields.io/twitter/url/https/github.com/tterb/hyde.svg?style=social)](https://twitter.com/intent/tweet?text=Check%20DataDrivenForms%20React%20library%21%20https%3A%2F%2Fdata-driven-forms.org%2F&hashtags=react,opensource,datadrivenforms) [![Twitter Follow](https://img.shields.io/twitter/follow/DataDrivenForms.svg?style=social)](https://twitter.com/DataDrivenForms)

[![Data Driven Form logo](https://raw.githubusercontent.com/data-driven-forms/react-forms/master/images/logo.png)](https://data-driven-forms.org/)

碳元件映射仪 [数据驱动窗体](https://github.com/data-driven-forms/react-forms)。 。 。 .

:手册:详情请访问 [文档](https://data-driven-forms.org/). : 书:

**目录**

-   [更多信息](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-more-information)
-   [安装](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-installation)
    -   [反应窗体渲染器](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-react-form-renderer)
    -   [碳映射器](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-carbon-mapper)
-   [使用量](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-usage)
-   [基本组成部分](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-basic-provided-components)
-   [有用链接](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-useful-links)
-   [捐款](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-contribution)
-   [自由主义](https://npmcn.com/package/%40data-driven-forms/carbon-component-mapper/#readme-license)

### 更多信息

更多信息请检查根 [仓库](https://github.com/data-driven-forms/react-forms) 或者我们 [文档页面](https://data-driven-forms.org/)。 。 。 .

### 安装

您需要添加反应窗体渲染器

#### [反应窗体渲染器](https://www.npmjs.com/package/@data-driven-forms/react-form-renderer)

```console
$ npm install @data-driven-forms/react-form-renderer -S
```

```console
$ yarn add @data-driven-forms/react-form-renderer
```

#### [碳映射器](https://data-driven-forms.org/mappers/carbon-component-mapper)

```console
$ npm install @data-driven-forms/carbon-component-mapper -S
```

```console
$ yarn add @data-driven-forms/carbon-component-mapper
```

### 使用量

要在组件中使用数据驱动窗体,您需要渲染器和组件映射器,它提供窗体Fields组件和布局Fields组件.

```jsx
import React from 'react';
import { FormRenderer, componentTypes } from '@data-driven-forms/react-form-renderer';
import { componentMapper, FormTemplate } from '@data-driven-forms/carbon-component-mapper';

const schema = {
  fields: [{
    component: componentTypes.TEXT_FIELD,
    name: 'name',
    label: 'Your name'
  }]
}

const Form = () => (
  <FormRenderer
    schema={schema}
    componentMapper={componentMapper}
    FormTemplate={FormTemplate}
    onSubmit={console.log}
  />
)
```

### 基本组成部分

数据驱动表单支持各种组件,基础集由:

-   [文本输入](https://data-driven-forms.org/mappers/text-field?mapper=carbon)
-   [文本区域](https://data-driven-forms.org/mappers/textarea?mapper=carbon)
-   [复选框](https://data-driven-forms.org/mappers/checkbox?mapper=carbon) (单位:千美元)[多个复选框](https://data-driven-forms.org/mappers/checkbox-multiple?mapper=carbon)(中文(简体) )
-   [选择( 下拉)](https://data-driven-forms.org/mappers/select?mapper=carbon)
-   [选择双列表](https://data-driven-forms.org/mappers/dual-list-select?mapper=carbon)
-   [字段阵列](https://data-driven-forms.org/mappers/field-array?mapper=carbon)
-   [切换](https://data-driven-forms.org/mappers/switch?mapper=carbon)
-   [无线电按钮](https://data-driven-forms.org/mappers/radio?mapper=carbon)
-   [选取日期者](https://data-driven-forms.org/mappers/date-picker?mapper=carbon)
-   [计时器](https://data-driven-forms.org/mappers/time-picker?mapper=carbon)
-   [标签](https://data-driven-forms.org/mappers/tabs?mapper=carbon)
-   [幻灯片](https://data-driven-forms.org/mappers/slider?mapper=carbon)
-   [小形式](https://data-driven-forms.org/mappers/sub-form?mapper=carbon)
-   [纯文本](https://data-driven-forms.org/mappers/plain-text?mapper=carbon)
-   [向导](https://data-driven-forms.org/mappers/wizard?mapper=carbon)

### 有用链接

-   [数据驱动窗体文档](https://data-driven-forms.org/)
-   [反应窗体渲染器](https://www.npmjs.com/package/@data-driven-forms/react-form-renderer)
-   [Carbon Mapper 国家预防机制](https://www.npmjs.com/package/@data-driven-forms/carbon-component-mapper)
-   [碳设计系统文件](https://www.carbondesignsystem.com/)
-   [碳反应复合物故事书](https://react.carbondesignsystem.com/)

### 捐款

我们欢迎任何社区的贡献。 不要害怕报告错误 或者制造问题和拉动请求! : 营养:

### 自由主义

Apache 许可证 2.0

## 常见问题

### @data-driven-forms/carbon-component-mapper 是什么？

用于Data Driven Forms的碳反应元件映射器\.

### 如何安装 @data-driven-forms/carbon-component-mapper？

在项目目录运行 npm install @data-driven-forms/carbon-component-mapper，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.2 \|\| ^18\.0\.0 \|\| ^19\.0\.0）、react-dom（^17\.0\.2 \|\| ^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @data-driven-forms/carbon-component-mapper 支持 TypeScript 吗？

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

### @data-driven-forms/carbon-component-mapper 支持 ESM 还是 CommonJS？

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

### @data-driven-forms/carbon-component-mapper 可以商用吗？

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

### @data-driven-forms/carbon-component-mapper 的下载量有多少？

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

### @data-driven-forms/carbon-component-mapper 还在维护吗？

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