# @activecollab/components 中文文档

规范地址：https://npmcn.com/package/%40activecollab/components/

版本：2\.0\.581
npm 元数据更新时间：2026-11-06T16:17:50.185Z
中文译文更新时间：2026-11-05T22:52:02.278Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40activecollab/components
原文对照：https://npmcn.com/package/%40activecollab/components/?lang=original
源码仓库：https://code.activecollab.com/a51/design-system

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

- 包体积（解压后）：48 MB，7221 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：17 个
- peer 依赖：react ^16\.12\.0 \|\| ^17\.0\.2 \|\| ^18\.2\.0，react-dom ^16\.12\.0 \|\| ^17\.0\.2 \|\| ^18\.2\.0
- 首次发布：2019-11-05T20:43:31.424Z
- 最新版本发布：2026-11-06T16:17:49.990Z
- 近 30 天下载量：10629（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：1531（近 12 个月 326 个）

## 中文简介

活动组合组件

## 安装

```sh
npm install @activecollab/components
```

也可以使用：`pnpm add @activecollab/components`、`yarn add @activecollab/components`、`bun add @activecollab/components`

## README

# 活动 Collab 设计系统

以"故事本"/"反应"所写的视觉语言.

### 安装

使用软件包管理器 [无](https://www.npmjs.com/) 以安装故事本和所有依赖.

```
npm install
```

### 启动开发环境

```
npm run start
```

### 建立制作故事书

```
npm run build:story
```

### 为制作制作故事

```
npm run build:dist
```

### 构建 SVG 图标

当将新的 SVG 图标包含到下面的 Storybook 运行命令时, 并在承诺中包含新生成的文件/相册 .

```
npm run build:icons
```

### 使用量

图标与包含的 svg 名称相同 .

`people.svg` 刚刚 `people`。 。 。 . 检查更多 [图标组件](https://system.activecollab.com/?path=/story/components-icons--icon)。 。 。 .

```
<Icon name="name" />
```

### 运行测试

```
npm run test
```

### 更新测试

```
npm run test -- -u
```

### 生成代码覆盖

```
npm run test:cov
```

### 清除所有 dist 文件夹( 如果需要)

```
npm run clean
```

### 命名公约

```
Components:

 Upper Camel case, with upper first letter.

    Example: DateStepper

Props:

    Camel case.

    Example: shouldDisplay

Tests:

    With test suffix.

    Example: DateStepper.test
```

## 捐款

欢迎拉动请求。 对于重大变动,请先开出一个问题来讨论你想要改变什么.

请确保酌情更新测试.

## 再见!

## 常见问题

### @activecollab/components 是什么？

活动组合组件

### 如何安装 @activecollab/components？

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

### @activecollab/components 支持 TypeScript 吗？

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

### @activecollab/components 支持 ESM 还是 CommonJS？

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

### @activecollab/components 可以商用吗？

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

### @activecollab/components 的下载量有多少？

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

### @activecollab/components 还在维护吗？

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