如何控制react-Lottie渲染的DOM元素类型(svg/video标签)
控制react-lottie实际渲染类型的方法
核心控制逻辑
react-lottie 会将传入的 options 全量透传给底层的lottie渲染实例,最终渲染为哪种DOM结构,完全由options里的renderer字段决定——你当前写的配置里没有显式设置这个字段,才会出现不同实例渲染类型不一致的情况。renderer 字段的三个标准可选值:
svg:库的默认值,最终会在DOM中输出<svg>标签,是兼容性最好的渲染模式canvas:最终会输出<canvas>画布标签,适合长时长、高复杂度的性能敏感型动画html:最终会输出普通HTML元素组合的动画结构,方便对动画的各个分层做独立交互绑定
为什么会出现video标签形式的渲染
原生lottie渲染库本身没有将动画输出为<video>标签的能力,你看到的这种渲染结果基本是两种原因导致的:
- 项目里同时混用了多套基于lottie封装的渲染组件,不同组件的默认渲染配置不统一,你没有给两个实例都显式锁定renderer类型
- 项目中注册了自定义的lottie渲染扩展,把对应动画的渲染逻辑替换成了基于video元素的实现,需要排查全局lottie实例的扩展注册代码定位问题
固定渲染类型的配置示例
如果需要强制把动画渲染为SVG格式,只需要在原有options配置里补上renderer字段就行:
const MyOptions: Options = { loop: true, autoplay: true, animationData, // 显式指定渲染类型,避免默认值波动 renderer: 'svg', rendererSettings: { preserveAspectRatio: 'xMidYMid slice', }, }; return ( <Lottie options={MyOptions}/> );
避坑提醒
如果你用的是@lottiefiles/dotlottie-react这类新版的lottie封装库,控制渲染类型的参数名可能会有变化(比如是rendererType),不要硬套旧版react-lottie的配置规则,对照所用包的TypeScript类型定义校验参数即可。
内容的提问来源于stack exchange,提问作者YTG
相关产品推荐
相关产品推荐

