You need to enable JavaScript to run this app. Expo实现卡片选中时播放Lottie动画的报错与状态切换失效问题
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 18:54:04