# @carbon/motion 中文文档

规范地址：https://npmcn.com/package/%40carbon/motion/

版本：11\.56\.0
npm 元数据更新时间：2026-11-04T14:06:48.580Z
中文译文更新时间：2026-11-09T02:39:02.375Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：133 kB，34 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2018-11-14T17:10:43.414Z
- 最新版本发布：2026-11-04T14:06:48.149Z
- 近 30 天下载量：742118（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：258（近 12 个月 40 个）

## 中文简介

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

## 安装

```sh
npm install @carbon/motion
```

也可以使用：`pnpm add @carbon/motion`、`yarn add @carbon/motion`、`bun add @carbon/motion`

## README

# @碳/运动

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

## 开始

要安装 `@carbon/motion` 在您的工程中, 您需要运行以下 命令使用 [无](https://www.npmjs.com/)数字 :

```bash
npm install -S @carbon/motion
```

如果你喜欢 [雅伦](https://yarnpkg.com/en/),使用以下命令 相反:

```bash
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`数字 :

```scss
@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);
}
```

可用的持续时间变量 :

```scss
@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` 函数和地表公用事业:

```js
// 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
```

## 捐款

我们总是寻找贡献者 帮助我们修复错误, 建立新的特性, 或者帮助我们改进项目文件。 如果你有兴趣,肯定 看看我们 [贡献指南](https://npmcn.com/.github/CONTRIBUTING.md)!

## 许可证

凭 [Apache 2.0 许可证](https://npmcn.com/LICENSE)。 。 。 .

## ![IBM Telemetry](https://raw.githubusercontent.com/ibm-telemetry/telemetry-js/main/docs/images/ibm-telemetry-light.svg) IBM 遥测

本套件使用 IBM 遥测来收集去识别和匿名的度量衡 数据。 通过安装此包作为依赖, 您同意远程测量 藏书。 选择退出,看 [选择退出IBM遥测数据收集](https://github.com/ibm-telemetry/telemetry-js/tree/main#opting-out-of-ibm-telemetry-data-collection)。 。 。 . 有关所收集数据的更多信息,请参见: [IBM 遥测文档](https://github.com/ibm-telemetry/telemetry-js/tree/main#ibm-telemetry-collection-basics)。 。 。 .

## 常见问题

### @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 和提交记录判断。