@carbon/layout

中文文档
11.63.0发布于 2026/11/04Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 97.4万

使用碳设计系统提供数字和软件产品的布局辅助工具

中文使用文档
文档目录6 节
  1. 开始
  2. 使用量
  3. 修改符号值
  4. 捐款
  5. 许可证
  6. IBM 遥测

@ 碳/放电

使用碳设计的数字和软件产品的布局助手 系统

开始

要安装 @carbon/layout 在您的工程中, 您需要运行以下 命令使用 无数字 :

npm install -S @carbon/layout

如果你喜欢 雅伦,使用以下命令 相反:

yarn add @carbon/layout

使用量

@carbon/layout 提供一些有用的公用事业,同时 iBM 设计语言网格系统的规格。 这个包 包括:

特性说明
断点IBM设计网格的变量和设置,包括地沟和断点. 它还包括帮助解决断点问题
单位改划转换工具 px 改为 rem 或者说 em。 。 。 .
键高在不同断点配合键高的助手
小型单位在小型单位多个单位工作的助手
间距为使用比例尺中的阶梯提供间隔尺度和帮助

要记住的一件事是 @carbon/layout 不负责 电网本身。 如果您想要使用网格执行,绝对 检查出来 @carbon/grid 软件包.

@carbon/layout 在 Sass 和 JavaScript 中提供上述特性。 若为 你用另一种语言寻求支持 自由提出一个问题 提议增加新内容!

修改符号值

标记值定义于 tokens/layout.tokens.json 使用 DTCG 符号格式这是 包件唯一的真相来源—— 不编辑生成的文件 直接。 。 。 .

下列文件是在构建时生成的,不应手动编辑:

  • js/generated/layout-tokens.js 编号 : js/generated/layout-tokens.d.ts - 联合来文 出口
  • scss/generated/ — Sass 变量和地图, 每个符号组一个文件

要添加或更新一个令牌 :

  1. 编辑 tokens/layout.tokens.json
  2. 运行 yarn build 在此包中重新生成所有输出
  3. 运行 yarn test --testPathPatterns=packages/layout 从 repo 根到 证实没有倒退

关于符号格式的详细指南以及如何添加新的符号类别, 见 tokens/README.md。 。 。 .

捐款

我们总是寻找贡献者 帮助我们修复错误, 建立新的特性, 或者帮助我们改进项目文件。 如果你有兴趣,肯定 看看我们 贡献指南!

许可证

凭 Apache 2.0 许可证。 。 。 .

IBM Telemetry IBM 遥测

本套件使用 IBM 遥测来收集去识别和匿名的度量衡 数据。 通过安装此包作为依赖, 您同意远程测量 藏书。 选择退出,看 选择退出IBM遥测数据收集。 。 。 . 有关所收集数据的更多信息,请参见: IBM 遥测文档。 。 。 .

版本与发布记录

@carbon/layout 共发布 305 个版本,首次发布于 2018/10/02;过去 12 个月发布了 42 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
11.63.0latest2026/11/044 天前
11.63.0-rc.02026/11/035 天前
12.0.0-alpha.4v12-alpha2026/10/2812 天前
12.0.0-alpha.32026/10/2118 天前
11.62.02026/10/2119 天前
11.62.0-rc.02026/10/2020 天前

其他发布通道:alpha → 0.0.1-alpha.32,beta → 0.0.1-beta.5,canary → 10.6.0-alpha.5708,nightly → 10.16.0-alpha.0,v10-next → 10.37.5,v12-alpha → 12.0.0-alpha.4。

关于 @carbon/layout 的常见问题

@carbon/layout 是什么?

使用碳设计系统提供数字和软件产品的布局辅助工具

如何安装 @carbon/layout?

在项目目录运行 npm install @carbon/layout,或使用 pnpm add / yarn add / bun add。

@carbon/layout 支持 TypeScript 吗?

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

@carbon/layout 支持 ESM 还是 CommonJS?

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

@carbon/layout 可以商用吗?

@carbon/layout 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@carbon/layout 的下载量有多少?

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

@carbon/layout 还在维护吗?

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