# @createjs/tweenjs 中文文档

规范地址：https://npmcn.com/package/%40createjs/tweenjs/

版本：2\.0\.0-beta\.4
npm 元数据更新时间：2022-05-16T15:12:18.392Z
中文译文更新时间：2026-11-11T00:00:22.929Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40createjs/tweenjs
原文对照：https://npmcn.com/package/%40createjs/tweenjs/?lang=original
项目主页：https://createjs.com/tweenjs
源码仓库：https://github.com/createjs/tweenjs

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

- 包体积（解压后）：531 kB，22 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2018-03-28T19:42:34.846Z
- 最新版本发布：2018-11-21T23:42:39.378Z
- 近 30 天下载量：6855（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

Javascript 的简单而强大的tweenning / 动画库. CreateJS图书馆套件的一部分.

## 安装

```sh
npm install @createjs/tweenjs
```

也可以使用：`pnpm add @createjs/tweenjs`、`yarn add @createjs/tweenjs`、`bun add @createjs/tweenjs`

## README

### 2.0 贝塔

**这个分支在β. 报告问题值得赞赏,请提及,问题机构是2.0.**

单位测试失败是已知的问题 请不要报告.

插件架构不完整,因此预计会断开.

[![tweenjs](https://raw.githubusercontent.com/createjs/tweenjs/2.0/assets/github-header.png)](https://createjs.com/tweenjs)

TweenJS是JavaScript中使用的简单编译库. 它的开发是为了与"EaselJS"库很好地融合,但并不依赖或特指它(虽然默认使用相同的Ticker和Event类). 它支持对数字对象属性和 CSS 样式属性进行tweing.

## 安装

#### 国家预防机制

`npm install @createjs/tweenjs --save`

#### 光盘N

`<script src="https://code.createjs.com/2.0/tweenjs.min.js"></script>`

## 简单示例

API虽然简单但非常强大,使得通过连锁命令可以很容易地创造出复杂的t.

```javascript
import { Tween } from "@createjs/tweenjs";
let tween = Tween.get(target)
    .to({ x: 300 }, 400)
    .set({ label: "hello!" })
    .wait(500)
    .to({ alpha: 0, visible: false }, 1000)
    .call((p1, p2) => { ... }, [ 10, true ]); // p1 === 10, p2 === true, this === target
```

上面的例子将产生一个新的特温实例:

-   将目标调整到300多分400毫秒的x值,并将其标签设置为"你好!"
-   等待500毫秒时
-   将目标alpha 调整为 0 大于 1s( 使其可见为虚假) (t)
-   调用“完成”函数

Tweens由两个要素组成:步骤和行动.

步骤定义了被子化的属性,并且始终具有与这些属性相关的持续时间(即使持续时间为0). 步骤用"to"和"wait"的方法定义. 步骤完全是决定性的。 你可以任意设置tween的位置,它会永远为这个位置设置相同的属性.

行动没有期限,在步骤之间执行。 它们的定义是: `call()`, (中文(简体) ), `set()`, (中文(简体) ), `play()`,以及 `pause()` 方法。 。 。 它们被保证按照正确的顺序执行,但不能在序列中指明的准确的时间时刻执行. 这可能导致不确定的结果,特别是在tweens通过游戏和暂停动作进行互动时.

Tweens支持一些配置属性,这些属性在创建新 tween 时被指定为第二段 :

```javascript
Tween.get(target, {
    loop: true,
    useTicks: true,
    css: true,
    ignoreGlobalPause: true
}).to(etc...);
```

所有配置属性默认为虚假 。 属性为:

`loop` - 说明当圆圈到尾端时是否应该循环

`useTicks` - 双胞胎会持续使用滴子而不是毫秒

`css` - 允许 css 映射一些 css 属性

`ignoreGlobalPause` - 滴答滴答滴答滴答滴答滴答滴答滴答滴答滴答滴答滴答滴答滴答.

使用时 `Tween.get()`,您也可以指定真实性作为第三个参数来覆盖目标上的任何活性扭矩.

```javascript
Tween.get(target, null, true); // this will remove any existing tweens on the target.
```

## 支助和资源

-   查找示例和更多信息 [TweenJS网站](http://createjs.com/tweenjs)。 。 。 .
-   读取 [文档](http://createjs.com/tweenjs/docs)。 。 。 .
-   讨论、分享项目,并与其他用户就 [编辑](http://www.reddit.com/r/createjs/)。 。 。 .
-   技术问题 [叠叠流](http://stackoverflow.com/questions/tagged/tweenjs)。 。 。 .
-   文件已校验出错误或正式特性请求 [GitHub 图像](https://github.com/createjs/tweenjs/issues)。 。 。 .
-   有一个 [谷歌组](http://groups.google.com/group/createjs-discussion) 供讨论和支持.
-   看看里面有什么东西 [实例](https://github.com/createjs/tweenjs/tree/master/examples) 更深入的指示.

它的建造者是 [gskinner.com (中文(简体) )](http://www.gskinner.com/),并且根据麻省理工学院的许可证免费发放,这意味着你可以将其用于几乎任何目的(包括商业项目). 我们尽可能赞赏功劳,但这不是一项要求.

## 谢谢

特别感谢 [罗伯特·潘纳](http://flashblog.robertpenner.com/) 他的宽松方程, 构成Ease类的基础.

## 常见问题

### @createjs/tweenjs 是什么？

Javascript 的简单而强大的tweenning / 动画库\. CreateJS图书馆套件的一部分\.

### 如何安装 @createjs/tweenjs？

在项目目录运行 npm install @createjs/tweenjs，或使用 pnpm add / yarn add / bun add。

### @createjs/tweenjs 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/createjs\_\_tweenjs 是否存在。

### @createjs/tweenjs 支持 ESM 还是 CommonJS？

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

### @createjs/tweenjs 可以商用吗？

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

### @createjs/tweenjs 的下载量有多少？

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

### @createjs/tweenjs 还在维护吗？

最新版本 2\.0\.0-beta\.4 发布于 2018/11/22（7 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2018/03/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。