开始
安装
npm install @canonical/maas-react-components
或使用线条 :
yarn add @canonical/maas-react-components
将样式导入到您的应用程序 :
@import "@canonical/maas-react-components/dist/style.css";
开发与 maas-react-components
看看你所做的改变 maas-react-components 请立即遵循这些步骤:
-
在那个 maas-react-components 目录,运行以下命令以创建同义链接:
yarn link
-
在消耗库(例如, maas-ui),运行以下命令以使用本地版本的 maas-react-components数字 :
yarn link "@canonical/maas-react-components"
-
继续 maas-react-components 目录和运行以下命令以启动以表旗的构建进程:
npm run build:watch
-
当你改变到 maas-react-components 它们将被自动建造 并反映在消耗的应用中.
创建新组件
一定要读我们 反应组件准则 在你继续之前.
从工程根部运行以下命令 :
npm run create-component
脚本将提示您输入新组件的细节 .
这将根据您提供的细节创建一个新的目录和文件 。 新文件将包含您新组件的基本设置,包括基本测试和故事书故事.
关于 @canonical/maas-react-components 的常见问题
@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 和提交记录判断。
