Expo实现卡片选中时播放Lottie动画的报错与状态切换失效问题
问题根因梳理
- 最核心的bug来自ref绑定逻辑:列表循环渲染时,所有LottieView共用同一个useRef实例,最终ref只会指向列表中最后一个渲染的Lottie组件,其余卡片的Lottie实例根本没有被ref捕获,才会触发
cannot read property 'play' of null的空引用报错。 - 初始配置完全偏离需求:第一版实现中硬编码
autoPlay={true},导致所有Lottie组件挂载就自动播放,完全违背“未选中时静态展示”的要求。 - 事件回调写法不规范:onPress回调中用逗号分隔语句块,没有正确组织执行逻辑,同时选中状态更新和动画播放的触发时序完全不对齐。
- 状态联动逻辑缺失:调整版的单个全局播放状态没有和每个卡片的选中态绑定,所有卡片共享同一个播放开关,根本无法实现“哪个卡片选中哪个播”的效果;且Expo环境下LottieView的
autoPlay属性在组件挂载完成后变更时,不会主动触发重新播放,必须通过实例方法控制才可靠。 - 额外的布局与配置隐患:原代码把LottieView直接嵌套在标签中,非文本组件嵌套在Text下会触发布局异常;同时
initialSegment的写法不符合组件要求,会导致配置解析错误,也是动画加载异常的潜在诱因。
正确实现方案
- 废弃单个共享ref的写法:用对象结构存储每个卡片对应的Lottie实例,对象的key为卡片唯一id,value为对应Lottie组件的实例引用,避免循环渲染的实例绑定错乱。
- 关闭所有Lottie的自动播放开关:把
autoPlay、loop的初始值全部设为false,组件挂载时默认停在initialSegment配置的静态帧,不触发任何播放逻辑。 - 以全局选中的卡片id作为唯一的播放控制依据:通过副作用监听选中id的变化,自动控制对应实例的播放/重置逻辑——选中的卡片调用
play()方法从预设段开始循环播放,未选中的卡片调用reset()方法回到静态帧停止播放。 - 修正列表渲染的基础规范:给每个列表项补充key属性,避免组件复用导致的实例错乱;把LottieView从Text标签中移出,避免布局异常。
参考实现代码
import { useEffect, useRef, useState } from 'react'; // 用对象结构存储所有卡片的Lottie实例,按卡片id做索引 const lottieInstanceMap = useRef({}); // 全局仅存储选中的卡片id,比存整个选中对象更稳定 const [selectedCardId, setSelectedCardId] = useState(null); // 监听选中态变化,自动控制所有Lottie实例的播放状态 useEffect(() => { Object.entries(lottieInstanceMap.current).forEach(([cardId, lottieInstance]) => { // 空值判断避免组件卸载时的空引用报错 if (!lottieInstance) return; if (cardId === selectedCardId) { // 选中卡片:启动循环播放 lottieInstance.loop = true; lottieInstance.play(); } else { // 未选中卡片:停回静态帧,关闭循环 lottieInstance.loop = false; lottieInstance.reset(); } }) }, [selectedCardId]); return ( filteredData.map((item) => { const isSelected = item.id === selectedCardId; return ( <TouchableOpacity key={item.id} onPress={() => setSelectedCardId(item.id)} > <View style={[{ alignItems: 'center' }, isSelected ? { paddingTop: 10 } : { paddingTop: 20 }]}> <CardioCard style={isSelected ? { backgroundColor: 'green' } : {}}> <CardItem style={[styles.card, isSelected ? { backgroundColor: 'green' } : {}]}> <LottieView // 用回调形式绑定ref,把每个实例存到对应id的索引位 ref={(instance) => { lottieInstanceMap.current[item.id] = instance; }} source={require('../../assets/images/heartbeat.json')} // initialSegment必须传数组格式配置帧范围 initialSegment={[68, 135]} // 初始状态:不自动播放,静态展示 autoPlay={false} loop={false} style={{ width: 100, height: 100 }} /> </CardItem> </CardioCard> <Text style={[{ fontSize: 18, color: 'hsl(98, 0%, 11%)', paddingLeft: 15 }, isSelected ? { fontFamily: 'ssb_SemiBold' } : {}]}> {item.name} </Text> </View> </TouchableOpacity> ) }) )
实现注意点
- 不要在事件回调里直接调用ref的方法,等状态更新的副作用触发播放控制,能完全避免时序错乱的问题。
- 组件卸载时ref回调会传入null,做空值判断就不会触发空引用报错。
- Lottie的实例方法必须在组件完全挂载完成后调用,放在副作用中执行能保证调用时实例已经初始化完成。
内容的提问来源于stack exchange,提问作者Bruce Mathers
相关产品推荐
相关产品推荐

