dotLottie 与 JSON:该用哪种 Lottie 格式发布
Lottie 动画有两种文件格式:最初的 .json 和较新的 .lottie(dotLottie)。它们描述的是同一个动画, 但打包方式截然不同——一个是人类可读的单一文本文档, 另一个是 zip 容器,可以一次装下多个动画、主题和图片。 选错会损失灵活性或体积。本文帮你做决定。
.json 到底是什么
.json 格式的 Lottie 文件就是一个动画,用一份 JSON 文档描述。 可以用文本编辑器打开、搜索、在版本控制里看 diff、手工改一个颜色或帧率。 它的结构见为什么你的 Lottie 文件有 70 MB: 画布尺寸与帧率的头信息、layers 数组, 以及放引用图片的 assets 数组。
纯 JSON 的优势是透明。任何能读 JSON 的东西都能读你的动画: 构建管线、CMS、一个批量改五十个文件颜色的脚本。 弱点是所有东西都在一个文本文件里。图片以内嵌 base64 data URL 的形式存在, 要付约 33% 的编码开销,而且整份文档必须作为一个整体解析。
.lottie 到底是什么
.lottie 文件是一个按约定布局的 zip 压缩包: 描述内容的 manifest.json、一个或多个动画 JSON 文件, 以及作为独立二进制条目存放的图片资源。因为图片以二进制而非 base64 文本存放, 容器避免了编码开销——同一个动画做成 .lottie 会比内嵌式的 .json 明显更小。
这个格式是为发布设计的,不是为编辑。你通常不会用文本编辑器打开 .lottie 文件,而是用支持 dotLottie 的播放器或工具打开, 它会解压、读 manifest、挑出需要的动画。
多动画与主题
dotLottie 的招牌能力是打包。一个 .lottie 文件可以装多个动画—— 比如同一个 UI 流程的待机、加载、成功、失败四种状态—— 再加命名主题,为浅色和深色模式重新着色。 播放器一次加载整个包,动画之间切换无需额外网络请求。
用纯 JSON,同样一组动画就是四个文件、四次请求、四次不同步的机会。 如果你要发布一组相关动画,dotLottie 是更干净的分发格式。
体积,实话实说
对纯矢量动画,两种格式差别很小:JSON 本来就很小, zip 容器省下的只是 base64 开销,而没有内嵌图片时这点开销几乎不存在。 有位图内容时差距变大:带内嵌 PNG 帧的动画做成 .lottie 会明显更小, 因为 PNG 是以二进制 zip 条目而非 base64 文本存放的。
但两种格式都不会压缩图片本身。一个装满 PNG 的 .lottie 文件, 依然是一个装满 PNG 的文件。如果体积是问题,解决办法是重编码图片帧, 不是换包装。lottie-mini 压缩工具同时接受 .json 和 .lottie 输入, 把内嵌图片重编码为 WebP,并且可以输出 .lottie—— 所以你可以把一个臃肿的 JSON 压小,再以更小的容器发布,一步完成。 首页的示例:70 MB 的文件压到约 1.1 MB,这是重编码带来的压缩幅度; 光换包装永远达不到。
播放器与工具支持
纯 JSON 被有史以来所有 Lottie 播放器支持,包括 lottie-web、iOS 和 Android 播放器。 dotLottie 需要播放器懂得解压和读 manifest—— Web、iOS、Android 的 dotLottie 播放器都支持,大多数现代工具也跟上了, 但如果你面向老旧或极简的播放器,JSON 是稳妥的选择。
制作端也是同样的分界。JSON 易于用通用工具生成、转换和检查。 dotLottie 易于发布,但生成它需要支持 dotLottie 的导出器或转换器。 如果你的管线就是脚本编辑 JSON 再推到 CDN, 就把 JSON 作为工作格式,只在最后需要时再转 dotLottie。
各自适合什么时候
- 用 .json,当:只有一个动画;需要最大的播放器兼容性; 管线要把文件当文本读取或转换;想在版本控制里看到干净的 diff; 或者要把动画内联进页面或邮件模板。
- 用 .lottie,当:有多个相关动画要一起分发; 需要主题(比如浅色/深色变体);动画带内嵌图片且想避免 base64 开销; 或者播放器已支持 dotLottie,你想要更小的下载体积。
一个实用的工作流
对大多数团队,合理的默认做法是:仓库里以 .json 作为事实来源, 因为它可 diff、可编辑。构建或发布时,在需要打包相关动画或发布图片时再转 .lottie,并且无论哪种格式都跑一遍压缩。 在 React 里渲染动画时,两种格式的嵌入代码是一样的——见如何在 React 中嵌入 Lottie—— 如果你还在动画格式之间整体犹豫,Lottie、GIF 与 MP4 的对比讲的是更宽的选择。
总结
JSON 是可编辑、通用、单动画的格式。dotLottie 是可发布、打包、多动画、 避免 base64 开销的格式。两者都不压缩你的图片——那是另外一步。 制作动画时用 JSON,分发一组动画时用 dotLottie,位图帧无论哪种都要压缩。