# @commercelayer/react-components 中文文档

规范地址：https://npmcn.com/package/%40commercelayer/react-components/

版本：5\.0\.12
npm 元数据更新时间：2026-11-10T10:11:05.142Z
中文译文更新时间：2026-11-10T12:03:06.930Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.5 MB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：13 个
- peer 依赖：react \>=19\.0\.0
- 首次发布：2020-04-23T10:29:45.902Z
- 最新版本发布：2026-11-10T10:11:04.723Z
- 近 30 天下载量：6162（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：645（近 12 个月 58 个）

## 中文简介

官方商业层反应组件

## 安装

```sh
npm install @commercelayer/react-components
```

也可以使用：`pnpm add @commercelayer/react-components`、`yarn add @commercelayer/react-components`、`bun add @commercelayer/react-components`

## README

# 商业层反应组件

一组可重复使用的 React 组件, 使其快速而简单地构建自己的定制商务 UI , 杠杆作用 [商业层 API](https://docs.commercelayer.io/api/)。 。 。 .

### 什么是商业层?

[商业层](https://commercelayer.io/) 是一个多市场商业API和订单管理系统,它允许您在任何网站,移动应用程序,聊天机,可穿戴,语音,或IoT设备中加入全局购物能力,轻松地. 用你已经掌握和热爱的最好的工具来整理你的堆叠. 通过一个快速的 企业级的 安全的API.

# 开始

关于不断更新的现有组件清单,请参见: [此交互式文档](https://commercelayer.github.io/commercelayer-react-components) 这将为您提供有关网络组件的所有必要信息,帮助您快速启动.

## 安装

商业层反应组件作为 [npm 软件包](https://www.npmjs.com/package/@commercelayer/react-components)数字 :

```bash
// npm
npm install @commercelayer/react-components

// yarn
yarn add @commercelayer/react-components

// pnpm
pnpm add @commercelayer/react-components
```

## 认证

所有对商业层 API 的请求必须使用 [OAuth2 证书](https://oauth.net/2/) 无记名符. 因此,要使用这些组件,需要获得有效的访问符. 一旦你得到它,你可以通过它作为道具 `CommerceLayer` 构成部分,如下:

```tsx
<CommerceLayer accessToken="your-access-token">

  {/* ... child components */}

</CommerceLayer>
```

> 来自V4? `endpoint` 财务报告和审定财务报表 `domain` 五、你的组织来自象征本身。 见 [从 v4 升级](https://commercelayer.github.io/commercelayer-react-components/?path=/docs/getting-started-upgrading-from-v4--docs) 用于完整的断开更改列表.

该标志将用于授权所有儿童部分的API呼叫. 这就是为什么存在(至少)一个 `CommerceLayer` 组件是强制性的——它必须包接您需要使用的所有其他组件.

> 请注意,如果需要用不同的符号(即来自不同的组织或使用具有不同作用和权限的应用软件)取取出数据,则没有任何东西妨碍你将同样数量的数据放出 `CommerceLayer` 要在同一页中的组件.

你可以检查 [我们的文件](https://docs.commercelayer.io/api/authentication) 关于现有授权流和杠杆的更多信息 [商业层](https://github.com/commercelayer/commercelayer-js-auth) 方便与我们的认证 API 交互.

## 需要帮忙吗?

-   联合 [商业层的迪斯科德社区](https://discord.gg/commercelayer)。 。 。 .
-   打开新的 [讨论](https://github.com/commercelayer/commercelayer-react-components/discussions/categories/q-a)
-   让我们继续 [布鲁斯基](https://bsky.app/profile/commercelayer.io), (中文(简体) ), [X (原Twitter) (中文(简体) )](https://x.com/commercelayer),或 [链接](https://www.linkedin.com/company/commerce-layer)。 。 。 .
-   有虫子吗? 创建一个 [问题](https://github.com/commercelayer/commercelayer-react-components/issues) 。在此仓库上.

### 许可证

此寄存器在 [麻省理工学院](https://npmcn.com/package/%40commercelayer/react-components/LICENSE) 执照.

## 常见问题

### @commercelayer/react-components 是什么？

官方商业层反应组件

### 如何安装 @commercelayer/react-components？

在项目目录运行 npm install @commercelayer/react-components，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @commercelayer/react-components 支持 TypeScript 吗？

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

### @commercelayer/react-components 支持 ESM 还是 CommonJS？

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

### @commercelayer/react-components 可以商用吗？

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

### @commercelayer/react-components 的下载量有多少？

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

### @commercelayer/react-components 还在维护吗？

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