# @alloc/moti 中文文档

规范地址：https://npmcn.com/package/%40alloc/moti/

版本：54\.0\.0-beta\.8
npm 元数据更新时间：2025-08-31T02:22:16.703Z
中文译文更新时间：2026-11-06T15:32:29.325Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：518 kB，228 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：expo-linear-gradient \*，react-native-linear-gradient \*，react-native-reanimated \*，react-native-safe-area-context \*
- 首次发布：2025-08-23T02:17:34.157Z
- 最新版本发布：2025-08-31T02:22:16.474Z
- 近 30 天下载量：2893（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

通用回想原生动画库,由回想3提供动力. QQ

## 安装

```sh
npm install @alloc/moti
```

也可以使用：`pnpm add @alloc/moti`、`yarn add @alloc/moti`、`bun add @alloc/moti`

## README

![](https://github.com/alloc/moti/blob/master/assets/banner2.png)

由再生3提供动力的通用回放原生动画库.

```jsx
<MotiView from={{ opacity: 0 }} animate={{ opacity: 1 }} />
```

# 文档实例( E)

-   [文档](https://moti.fyi/)
-   [安装](https://moti.fyi/installation)
-   [实例](https://moti.fyi/examples/hello-world)

## 下一个.js Conf

![Screen Shot 2021-10-22 at 3 00 05 PM](https://user-images.githubusercontent.com/13172299/138509139-412b2d32-841b-4a7e-950e-f8721c1da17f.png)

我说话在 [Next.js Conf 2021 (英语)](https://fernandorojo.co/conf) 10月26日,关于React Industrial + Next.js. [看着视频](https://t.co/LkmxHXVz3K?amp=1) 看看我们怎么做到的.

# 要点

-   通用:所有平台的作品
-   60个FPS动画原生线
-   挂载/卸载动画, 如 `framer-motion`
-   由再动3提供动力
-   网络支持, 退出
-   博览支持
-   直观 API
-   备选案文
-   强大的类型脚本支持
-   高清晰度动画
-   序列动画
-   循环动画( C)

# 预览

-   [API 密码](https://twitter.com/FernandoTheRojo/status/1348093995277299712)
-   [卸载动画 `exit`](https://twitter.com/FernandoTheRojo/status/1349884929765765123)
-   [`exitBeforeEnter` 动画](https://twitter.com/FernandoTheRojo/status/1351234878902333445)

# 跟随

跟我来 [在推特上进行](https://twitter.com/fernandotherojo) 随时更新.

# 发起人

请联系 [费尔南多·罗霍](https://twitter.com/fernandotherojo) 如果你有兴趣赞助莫蒂.

[![Analytics by Splitbee.io](https://splitbee-cdn.fra1.cdn.digitaloceanspaces.com/static/badge/splitbee-badge-dark.svg)](https://splitbee.io/?ref=badge)

## 常见问题

### @alloc/moti 是什么？

通用回想原生动画库,由回想3提供动力\. QQ

### 如何安装 @alloc/moti？

在项目目录运行 npm install @alloc/moti，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react-native-reanimated（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @alloc/moti 支持 TypeScript 吗？

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

### @alloc/moti 支持 ESM 还是 CommonJS？

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

### @alloc/moti 可以商用吗？

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

### @alloc/moti 的下载量有多少？

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

### @alloc/moti 还在维护吗？

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