搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

airbnb/lottie-web

多媒体与设计

把 After Effects 动画导出为 JSON 后,在网页中通过 SVG、Canvas 或 HTML 原生播放。

32,476
2,977
JavaScript
MIT
创建于 11 年前

项目介绍

lottie-web 解析用 Bodymovin 插件从 Adobe After Effects 导出的 JSON 动画,并在网页中直接渲染,让设计师做好的动效不必再交给工程师逐帧重做。同一套动画格式还有 Android、iOS、React Native 和 Windows 版本。播放器提供 SVG、Canvas、HTML 三种渲染方式,常用于页面中的加载动画、图标动效、品牌插画等场景。

核心入口是 lottie.loadAnimation(),通过 animationData(内联数据)或 path(JSON 地址)加载动画,并传入 container、renderer、loop、autoplay 等参数;返回的实例支持 play、pause、setSpeed、goToAndStop、playSegments、destroy 等控制方法。库还提供 lottie.setQuality()、lottie.setLocationHref() 这类全局方法,以及 onComplete、enterFrame、data_ready 等事件。逐项配置可查看 Composition Settings 文档。

快速使用

网页播放器通过 npm 安装:

npm install lottie-web

也可以直接使用 build/player/ 下的 lottie.js,或加载 CDN 版本。在页面中引入后加载导出的 JSON:

<script src="js/lottie.js" type="text/javascript"></script>
<div id="anim" style="width:400px;height:400px"></div>
<script>
  lottie.loadAnimation({
    container: document.getElementById('anim'),
    renderer: 'svg',
    loop: true,
    autoplay: true,
    path: 'data.json'
  });
</script>

JSON 来自 After Effects 里的 Bodymovin 扩展:打开扩展面板,选择合成,指定导出目录,点击 Render 生成。可参考 Codepen 基础示例 和 示例集合,视频教程 演示了从导出到在页面中加载的完整流程。

使用约束

渲染器支持 svg(默认)、canvas、html。如果动画包含重复器并计划把同一对象多次传给 loadAnimation,需要先深拷贝,详见 issue #1159 与 #2151。使用已有 canvas 上下文渲染时,需要自行在每帧后清空画布;rendererSettings 还支持无障碍标题/描述、progressiveLoad 等选项。也可以声明式地给 div 加 lottie 类和 data-animation-path 属性,页面加载后调用 lottie.searchAnimations()。

AE 特性方面,支持预合成、形状、纯色层、图片、空对象、文本、蒙版、时间重映射和表达式;不支持图像序列、视频和音频,也不支持负值的图层拉伸。图片和未转成形状的 AI 图层会导出到 images 目录,导出时注意不要覆盖目标位置的同名文件夹。实时渲染对性能敏感,过大的形状、过多的节点和巨型蒙版都会拖慢播放;把矢量图层转为形状,并对 JSON 和播放器做 gzip 压缩,能明显减小体积。

项目采用 MIT 许可证。Bodymovin 插件推荐从 aescripts 获取,也可以通过 Adobe Exchange、仓库 build/extension 中的 .zxp 或 Homebrew 安装。安装后需在 After Effects 的脚本与表达式偏好设置中勾选 “Allow Scripts to Write Files and Access Network”。Safari 下由 <base> 标签引起的蒙版问题,可在创建动画前调用 lottie.setLocationHref() 解决。

HotRepo 点评

这是一个成熟的库:仓库创建于 2015 年,累计约 3.2 万 Star。最近一次记录的 JavaScript 语言日榜快照是 2026 年 11 月 16 日,当天排名第 10、新增 22 Star,说明项目仍在持续获得关注;站内暂无全部语言日榜名次记录。较早的发布时间和多平台兄弟库,让它适合需要把动效稳定接入 Web UI 的团队;实际使用中最需要注意的是控制导出 JSON 的体积和复杂度,以保证运行时性能。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Lottie for Web, Android, iOS, and React Native
▲ 1 · 0 条评论 · 2017年11月20日