更新记录
1.0.7(2019-12-04) 下载此版本
init
平台兼容性
lottie-miniprogram
lottie 动画库适配微信小程序的版本,
lottie 的相关介绍与动画生成方法等请参考 官方说明
目前在uni-app中仅支持微信小程序,且依赖小程序基础库版本 >= 2.8.0 的环境
插件使用
- HBuilderX 引入
下载或导入示例获取插件
import lottie from '@/common/lottie-miniprogram.js'
- npm 安装
-
如果是 HBuilderX 创建的工程,需要先执行
npm init
npm init -y // 初始化项目
-
npm 安装插件
npm install --save lottie-miniprogram
- 传入 canvas 对象用于适配
<canvas id="canvas" type="2d" style="display: inline-block; width: 300px; height: 300px;"></canvas>
import lottie from '@/common/lottie-miniprogram.js'
// import lottie from 'lottie-miniprogram'
export default {
onReady() {
uni.createSelectorQuery().select('#canvas').node(res => {
const canvas = res.node
lottie.setup(canvas)
}).exec()
}
}
- 使用 lottie 接口
lottie.setup(canvas)
lottie.loadAnimation({
...
})
接口
目前提供两个接口:
lottie.setup(canvas)
需要在任何 lottie
接口调用之前调用,传入 canvas
对象
lottie.loadAnimation(options)
与原来的 loadAnimation 有些不同,支持的参数有:
- loop
- autoplay
- animationData
- path (只支持网络地址)
- rendererSettings.context (必填)
说明
- 本项目以 npm 的方式依赖原 lottie-web 项目,若原项目有新版本,可直接改变依赖的版本号。
- 本项目依赖小程序基础库 2.8.0 里性能更好的 canvas 实现,由于还有些小问题没有正式开放,但目前用在此处暂无发现问题。
- 由于小程序本身不支持动态执行脚本,因此
lottie
的expression
功能也是不支持的。