Fabric.js 中实现 Lottie 动画支持的技术方案

背景介绍

Fabric.js 是一个功能强大的 Canvas 库，用于创建交互式的图形应用程序。在实际开发中，我们经常需要将 Lottie 动画集成到 Fabric.js 画布中。Lottie 是 Airbnb 开发的一种基于 JSON 的动画格式，可以轻松实现复杂的矢量动画效果。

技术实现方案

基础类继承与初始化

在 Fabric.js 中实现 Lottie 支持，最佳实践是继承 fabric.Image 类。通过这种方式，我们可以利用 Fabric.js 已有的图像处理能力，同时添加 Lottie 特有的功能。

class Lottie extends fabric.Image {
  constructor(path: string, options?: any) {
    // 设置默认宽高
    if (!options?.width) options.width = 480;
    if (!options?.height) options.height = 480;

    // 创建临时画布用于渲染
    const tmpCanvasEl = fabric.util.createCanvasElement();
    tmpCanvasEl.width = options.width;
    tmpCanvasEl.height = options.height;

    // 初始化Lottie动画
    const lottieItem = lottie.loadAnimation({
      renderer: 'canvas',
      loop: true,
      autoplay: true,
      path,
      rendererSettings: {
        context: tmpCanvasEl.getContext('2d'),
        preserveAspectRatio: 'xMidYMid meet',
      },
    });

    // 监听动画帧更新事件
    lottieItem.addEventListener('enterFrame', () => {
      this.canvas?.requestRenderAll();
    });

    // 调用父类构造函数
    super(tmpCanvasEl, options);
    
    // 保存Lottie相关属性
    this.path = path;
    this.tmpCanvasEl = tmpCanvasEl;
    this.lottieItem = lottieItem;
  }
}

动画控制方法

为了提供完整的 Lottie 功能，我们需要实现基本的动画控制方法：

class Lottie extends fabric.Image {
  // ...其他代码
  
  // 播放动画
  play() {
    this.lottieItem.play();
  }
  
  // 暂停动画
  stop() {
    this.lottieItem.stop();
  }
  
  // 获取动画源路径
  getSrc() {
    return this.path;
  }
}

序列化与反序列化

在 Fabric.js 中，对象的序列化和反序列化是非常重要的功能。我们可以利用 Fabric.js 6.0 的新特性来实现：

class Lottie extends fabric.Image {
  // ...其他代码
  
  static fromObject<T extends fabric.IImageOptions>(
    { filters, resizeFilter, src, crossOrigin, ...object }: T,
    options?: fabric.Abortable
  ) {
    return Promise.all([
      // 加载Lottie动画
      Promise.resolve(), // 这里需要替换为实际的加载逻辑
      filters && fabric.util.enlivenObjects<fabric.BaseFilter>(filters, options),
      resizeFilter && fabric.util.enlivenObjects<fabric.BaseFilter>([resizeFilter], options),
      fabric.util.enlivenObjectEnlivables(object, options),
    ]).then(([, filters = [], [resizeFilter] = [], hydratedProps = {}]) => {
      return new this(src!, {
        ...object,
        src,
        filters,
        resizeFilter,
        ...hydratedProps,
      });
    });
  }
}

使用示例

创建并添加 Lottie 动画到画布非常简单：

const fabricImage = new Lottie('https://example.com/animation.json', {
  scaleX: 0.5,
  left: 100,
  top: 100
});
canvas.add(fabricImage);

注意事项

1. 性能考虑：Lottie 动画会不断重绘，需要注意性能优化
2. 事件处理：确保正确处理动画生命周期事件
3. 版本兼容：Fabric.js 6.0 的 API 与之前版本有较大变化
4. 类型安全：在 TypeScript 中实现时，要注意类型定义

总结

通过继承 Fabric.js 的 Image 类并集成 Lottie 动画，我们可以轻松地在 Canvas 中实现复杂的矢量动画效果。这种方案既利用了 Fabric.js 的强大功能，又保留了 Lottie 动画的所有特性，是一种非常实用的技术实现方案。