animation-view

Lottie动画组件，动画资源参考Lottie官方链接。

animation-view组件是uts组件，需下载插件：animation-view，仅app平台 nvue/uvue 页面支持

uts组件需 HBuilderX 3.7.0+

本地编译需要 gradle 7.5 及以上版本

app平台真机运行需要打自定义基座

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	QQ小程序	快应用	360小程序	快手小程序	京东小程序	元服务	小红书小程序
√	x	x	x	√	x	x	x	x	x	x	x	x

HarmonyOS Next 兼容性

HarmonyOS Next
x

• animation-view 在app平台集成的是lottie官方原生sdk，仅nvue/uvue页面支持，vue页面不支持。vue页面可使用webview、或renderjs集成lottie的h5版、或使用下方的微信小程序方案。
• app平台实现使用了Lottie官方SDK，开源项目：Lottie for Android，Lottie for iOS
  • app-android平台要求Android5（API Leavel 21）及以上系统
  • app-ios平台要求iOS11及以上版本系统
• 微信小程序没有内置该组件，需使用开源项目https://github.com/wechat-miniprogram/lottie-miniprogram
• 百度小程序已经由百度官方内置了animation-view，底层基于lottie sdk实现。
• 微信、百度之外的其他小程序，可考虑webview加载lottie的h5版，或评估上面的lottie-miniprogram是否兼容。

属性说明

属性名	类型	默认值	说明
path	String		动画资源地址，支持本地路径和网络路径
loop	Boolean	false	动画是否循环播放
autoplay	Boolean	true	动画是否自动播放
action	String	play	动画操作，可取值 play、pause、stop
hidden	Boolean	true	是否隐藏动画
@bindended	EventHandle		当播放到末尾时触发 ended 事件（自然播放结束会触发回调，循环播放结束及手动停止动画不会触发）

注意

• 百度小程序平台path属性目前不支持远程地址，仅支持本地绝对路径，详情

代码示例

<template>
	<view>
		<animation-view class="animation" :path="path" :loop="loop" :autoplay="autoplay" :action="action"
			:hidden="hidden" @bindended="lottieEnd">
		</animation-view>
		<button @click="playLottie" type="primary">{{status}}lottie动画</button>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				path: '/uni_modules/uni-animation-view/static/lottie.json',
				loop: false,
				autoplay: true,
				action: 'stop',
				hidden: false,
				status: '播放'
			}
		},
		methods: {
			playLottie() {
				this.action = ('play' !== this.action) ? 'play' : 'pause';
				this.status = ('pause' === this.action) ? '播放' : '暂停';
			},
			lottieEnd() {
				this.status = '播放';
				this.action = 'stop';
				console.log('动画播放结束');
			}
		}
	}
</script>

<style>
	.animation {
		width: 750rpx;
		height: 300rpx;
		background-color: #FF0000;
		margin-bottom: 20px;
	}
</style>