# @canonical/maas-react-components 中文文档

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

版本：3\.0\.7
npm 元数据更新时间：2026-11-09T09:58:34.302Z
中文译文更新时间：2026-11-09T09:22:31.873Z
软件包许可：AGPL-3\.0

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

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

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

- 包体积（解压后）：1.8 MB，198 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：msw ^3\.0\.3，react ^19\.1\.0，vitest ^5\.1\.0，react-dom ^19\.1\.0，classnames ^2\.3\.2，@types/react ^19\.1\.2，react-router \>=6\.0\.0，react-dropzone ^14\.3\.8，@types/react-dom ^19\.1\.3，@canonical/styles ^0\.37\.0 \|\| ^0\.45\.0，@canonical/ds-assets ^0\.37\.0 \|\| ^0\.45\.0，@tanstack/react-query ^5\.100\.11，@tanstack/react-table ^8\.15\.3，@testing-library/react ^16\.0\.0，@canonical/react-ds-global ^0\.37\.0 \|\| ^0\.45\.0，@canonical/react-components ^4\.5\.0，@testing-library/user-event ^14\.0\.0，@canonical/react-ds-global-form ^0\.37\.0 \|\| ^0\.45\.0
- 首次发布：2023-10-03T07:21:43.012Z
- 最新版本发布：2026-11-09T09:58:34.053Z
- 近 30 天下载量：4273（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 42 个）

## 中文简介

反应组件,用于MAAS UI项目.

## 安装

```sh
npm install @canonical/maas-react-components
```

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

## README

# MAAS 反应组件

  
![Canonical MAAS](https://assets.ubuntu.com/v1/142ae045-Canonical%20MAAS.png)  
  

用于MAAS UI项目的反应组件库.

它包含特定或仅在MAAS中使用的组件.  
普通用途部分应添加到 [@ canonical/ react- 组件](https://github.com/canonical/react-components) 换句话说.

**[故事书](https://canonical.github.io/maas-react-components/)** | **[哲学和准则](https://npmcn.com/package/%40canonical/maas-react-components/GUIDELINES.md)**

* * *

## 开始

### 安装

```bash
npm install @canonical/maas-react-components
```

或使用线条 :

```bash
yarn add @canonical/maas-react-components
```

将样式导入到您的应用程序 :

```css
@import "@canonical/maas-react-components/dist/style.css";
```

## 开发与 `maas-react-components`

看看你所做的改变 `maas-react-components` 请立即遵循这些步骤:

1.  在那个 `maas-react-components` 目录,运行以下命令以创建同义链接:
    
    ```bash
    yarn link
    ```
    
2.  在消耗库(例如, `maas-ui`),运行以下命令以使用本地版本的 `maas-react-components`数字 :
    
    ```bash
    yarn link "@canonical/maas-react-components"
    ```
    
3.  继续 `maas-react-components` 目录和运行以下命令以启动以表旗的构建进程:
    
    ```bash
    npm run build:watch
    ```
    
4.  当你改变到 `maas-react-components` 它们将被自动建造 并反映在消耗的应用中.
    

### 创建新组件

一定要读我们 **[反应组件准则](https://npmcn.com/package/%40canonical/maas-react-components/GUIDELINES.md)** 在你继续之前.

从工程根部运行以下命令 :

`npm run create-component`

脚本将提示您输入新组件的细节 .

这将根据您提供的细节创建一个新的目录和文件 。 新文件将包含您新组件的基本设置,包括基本测试和故事书故事.

## 常见问题

### @canonical/maas-react-components 是什么？

反应组件,用于MAAS UI项目\.

### 如何安装 @canonical/maas-react-components？

在项目目录运行 npm install @canonical/maas-react-components，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.1\.0）、react-dom（^19\.1\.0）、classnames（^2\.3\.2）、@types/react（^19\.1\.2）、react-router（\>=6\.0\.0）、react-dropzone（^14\.3\.8）、@types/react-dom（^19\.1\.3）、@canonical/styles（^0\.37\.0 \|\| ^0\.45\.0）、@canonical/ds-assets（^0\.37\.0 \|\| ^0\.45\.0）、@tanstack/react-query（^5\.100\.11）、@tanstack/react-table（^8\.15\.3）、@canonical/react-ds-global（^0\.37\.0 \|\| ^0\.45\.0）、@canonical/react-components（^4\.5\.0）、@canonical/react-ds-global-form（^0\.37\.0 \|\| ^0\.45\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @canonical/maas-react-components 支持 TypeScript 吗？

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

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

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

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

@canonical/maas-react-components 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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