# @createjs/easeljs 中文文档

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

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

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

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

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

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

## 中文简介

Easel JavaScript 库提供了完整,分级的显示列表,核心交互模型,以及帮助者类,使HTML5 Canvas元素的工作更加容易. CreateJS图书馆套件的一部分.

## 安装

```sh
npm install @createjs/easeljs
```

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

## README

### 2.0 贝塔

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

这个 `StageGL` 类在1.1中被重重重写,没有移植到ES2015语法. 我们暂时把它排除在这个分支之外。 课程完成后将重新加入.

基于Canvas的图像比较单元测试已知失败,请不要为此报告出问题.

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

EaselJS是HTML5中用于构建高性能交互式2D内容的库. 它提供了丰富的展示 列表中允许您操作和动画。 它还为鼠标和触摸提供了强大的互动模式 互动.

它对于构建游戏,基因艺术,广告,数据可视化,以及其他高度图形化的经验都非常出色. 这个 单独或与其他人一起工作 [创建 JS](https://createjs.com/) 套接字组 : [声音JS](https://github.com/createjs/soundjs), (中文(简体) ), [预装JS](https://github.com/createjs/preloadjs),以及 [图文JS](https://github.com/createjs/tweenjs)。 。 。 .

它没有外部依赖性,应该与你喜欢使用的任何框架几乎兼容.

## 安装

#### 国家预防机制

`npm install @createjs/easeljs --save`

#### 光盘N

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

## 简单示例

```javascript
// Draw a square on screen.
import { Stage, Shape } from "@createjs/easeljs";
let stage = new Stage("myCanvas");
let shape = new Shape();
shape.graphics.beginFill("red").drawRect(0, 0, 120, 120);
stage.addChild(shape);
stage.update();
```

## Sprite 动画示例

```javascript
import { Sprite, SpriteSheet, Ticker } from "@createjs/easeljs";
let ss = new SpriteSheet({
  frames: {
    width: 32,
    height: 64,
    numFrames: 19
  },
  animations: {run: [0, 25], jump: [26, 63, "run"]},
  images: ["./assets/runningGrant.png"]
});

let sprite = new Sprite(ss, "run");
sprite.scaleY = sprite.scaleX = 0.4;
stage.addChild(sprite);

sprite.on("click", evt => sprite.gotoAndPlay("jump"));

Ticker.on("tick", stage);
```

## 支助和资源

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

它的建造者是 [gskinner.com (中文(简体) )](http://www.gskinner.com/)根据麻省理工学院的许可免费放行,这意味着你 几乎可以用于任何目的(包括商业项目)。 我们尽可能感谢功劳,但这不是 页:1.

## 常见问题

### @createjs/easeljs 是什么？

Easel JavaScript 库提供了完整,分级的显示列表,核心交互模型,以及帮助者类,使HTML5 Canvas元素的工作更加容易\. CreateJS图书馆套件的一部分\.

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

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

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

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

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

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

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

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

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

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

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

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

