• lottie-miniprogram
    • 使用
    • 接口
    • 说明

    lottie-miniprogram

    lottie 动画库适配小程序的版本。

    lottie 的相关介绍与动画生成方法等请参考 官方说明

    依赖小程序基础库版本 >= 2.8.0 的环境

    使用

    可参考该代码片段:https://developers.weixin.qq.com/s/2TYvm9mJ75bF。大致步骤如下:

    • 通过 npm 安装:
    1. npm install --save lottie-miniprogram
    • 传入 canvas 对象用于适配
    1. <canvas id="canvas" type="2d"></canvas>
    1. import lottie from 'lottie-miniprogram'
    2. Page({
    3. onReady() {
    4. wx.createSelectorQuery().select('#canvas').node(res => {
    5. const canvas = res.node
    6. lottie.setup(canvas)
    7. }).exec()
    8. }
    9. })
    • 使用 lottie 接口
    1. lottie.setup(canvas)
    2. lottie.loadAnimation({
    3. ...
    4. })

    接口

    目前提供两个接口:

    lottie.setup(canvas)

    需要在任何 lottie 接口调用之前调用,传入 canvas 对象

    lottie.loadAnimation(options)

    与原来的 loadAnimation 有些不同,支持的参数有:

    • loop
    • autoplay
    • animationData
    • path (只支持网络地址)
    • rendererSettings.context (必填)

    说明

    • 本项目是以 npm 的方式依赖原 lottie-web 项目,若原项目有新版本,可直接改变依赖的版本号。
    • 本项目依赖小程序基础库 2.8.0 里性能更好的 canvas 实现,由于还有些小问题没有正式开放,但目前用在此处暂无发现问题。
    • 由于小程序本身不支持动态执行脚本,因此 lottie 的 expression 功能也是不支持的。