@bpmn-io/c4-theme

中文文档
0.3.3发布于 2026/10/30MIT零依赖近 30 天下载 3万

Bpmn.io 的 Camunda 设计系统主题

中文使用文档
文档目录3 节
  1. 使用量
  2. 构建和运行
  3. 许可证

@bpmn-io/c4-主题

CI

使bpm.io看起来像 卡蒙达设计系统 (C4级).

它通过重新指定 @bpmn-io/theme c4语义符号 符号,所以每个 bpm.io 组件一次导入一个主题 。 颜色总是 来源于C4;它所暗示的结构——弧度,间隔,控制高度,幽灵 按钮 – 跟随 阴影/ ui c4公约是 继续发展.

使用量

打开 .c4-ui 在您的应用程序根上(它带有设计系统的符号), 装入基本组件 CSS, 然后是共享的令牌和每个适配器 正在使用中组件。 主题范围为: .c4-ui因此导入样式表 是唯一的选择 :

<body class="c4-ui">
  <div id="canvas"></div>
  <div id="properties-panel"></div>
</body>
import '@camunda/design-system/styles.css';
import '@bpmn-io/properties-panel/dist/assets/properties-panel.css';
import '@bpmn-io/c4-theme/assets/tokens.css';
import '@bpmn-io/c4-theme/assets/properties-panel.css';

每个适配器在其主题组件的基底CSS后加载. 另选主题 图表表面——调色板、搜索垫和弹出编辑器( 创建、附加和替换菜单)——负载 diagram.css bpmn -js 之后的游戏 样式表 :

import 'bpmn-js/dist/assets/diagram-js.css';
import 'bpmn-js/dist/assets/bpmn-js.css';
import '@bpmn-io/c4-theme/assets/tokens.css';
import '@bpmn-io/c4-theme/assets/diagram.css';

暗模式遵循设计系统本身 dark 类——主题没有 其自有的调色板,所以它继承了C4决心的任何.

构建和运行

通过安装所有依赖来准备工程 :

npm install

然后,根据您的使用大小写,您可以运行以下任何命令:

# lint and run all tests
npm run all

# run all tests
npm test

# spin up the canonical playground to try the theme end-to-end
npm start

# capture side-by-side theme comparison screenshots into .captures/
npm run capture

为了探索更狭窄的地表, it.only 假想或旋转其中之一 特定组成部分游乐场:

npm run start:properties-panel
npm run start:diagram
npm run start:bpmn
npm run start:dmn

许可证

麻省理工学院

版本与发布记录

@bpmn-io/c4-theme 共发布 7 个版本,首次发布于 2026/09/17;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.3.3latest2026/10/309 天前
0.3.22026/10/2612 天前
0.3.12026/10/2018 天前
0.3.02026/10/1326 天前
0.2.02026/10/1326 天前
0.1.02026/09/221 个月前

其他发布通道:alpha → 0.0.1-alpha.0。

关于 @bpmn-io/c4-theme 的常见问题

@bpmn-io/c4-theme 是什么?

Bpmn.io 的 Camunda 设计系统主题

如何安装 @bpmn-io/c4-theme?

在项目目录运行 npm install @bpmn-io/c4-theme,或使用 pnpm add / yarn add / bun add。

@bpmn-io/c4-theme 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/bpmn-io__c4-theme 是否存在。

@bpmn-io/c4-theme 可以商用吗?

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

@bpmn-io/c4-theme 的下载量有多少?

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

@bpmn-io/c4-theme 还在维护吗?

最新版本 0.3.3 发布于 2026/10/30(9 天前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/09/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。