@carbon/motion

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

使用碳设计系统提供数字和软件产品的动议助手

中文使用文档
文档目录7 节
  1. 开始
  2. 使用量
  3. 萨斯
  4. Java 脚本
  5. 捐款
  6. 许可证
  7. IBM 遥测

@碳/运动

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

开始

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

npm install -S @carbon/motion

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

yarn add @carbon/motion

使用量

@carbon/motion 支持标准曲线、出入口曲线和出入口曲线为 二 运动模式:生产性和表现性。 它还提供期限标志和 名为运动表面。 您可以使用 Sass 或 JavaScript 访问这些 .

构建注释 : 脚本值在构建时生成: tokens/motion.tokens.json 财务报告和审定财务报表 tokens/surfaces.tokens.json运行 yarn build (或 npm run build克隆后一次 js/generated/ 财务报告和审定财务报表 scss/generated/ 在场.

萨斯

@carbon/motion 出口a motion 函数和 motion 用于放松的混合 曲线、 长度符号变量, a surface 函数和 surface 混合用于 名为运动表面。 把包裹带进来 @use数字 :

@use '@carbon/motion';

.my-selector {
  // Easing curve — productive mode by default
  transition-timing-function: motion.motion(standard);
}

.my-selector-expressive {
  // Easing curve with explicit mode, set as transition-timing-function
  @include motion.motion(standard, expressive);
}

.my-panel {
  // Apply a named motion surface (handles enter/exit keyframes and timing)
  @include motion.surface(contextual);
}

可用的持续时间变量 :

@use '@carbon/motion';

.my-selector {
  transition-duration: motion.$duration-fast-01; // 70ms
  transition-duration: motion.$duration-moderate-01; // 150ms
  transition-duration: motion.$duration-slow-01; // 400ms
}

Java 脚本

如果你在用的话 @carbon/motion 作为JavaScript的依赖,我们出口放松, 期限符号, a motion 函数和地表公用事业:

// ESM
import {
  easings,
  motion,
  // Duration tokens
  durationFast01,
  durationModerate01,
  durationSlow01,
  // Surface utilities
  surfaces,
  getMotionSurface,
  defineMotionSurface,
} from '@carbon/motion';

motion('standard', 'productive'); // Returns a string `cubic-bezier()` function
getMotionSurface('contextual'); // Returns the surface definition object

捐款

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

许可证

凭 Apache 2.0 许可证。 。 。 .

IBM Telemetry IBM 遥测

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

版本与发布记录

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

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

其他发布通道:alpha → 0.0.1-alpha.32,beta → 0.0.1-beta.5,canary → 10.5.0-alpha.5640,nightly → 10.11.0-alpha.0,v10-next → 10.29.5,v12-alpha → 12.0.0-alpha.4。

关于 @carbon/motion 的常见问题

@carbon/motion 是什么?

使用碳设计系统提供数字和软件产品的动议助手

如何安装 @carbon/motion?

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

@carbon/motion 支持 TypeScript 吗?

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

@carbon/motion 支持 ESM 还是 CommonJS?

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

@carbon/motion 可以商用吗?

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

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

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

@carbon/motion 还在维护吗?

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