LottieIcon 设计文档

Lottie 动画图标:依赖注入 player 工厂(库不绑定 lottie-web,用户自带),data 内联 JSON 或 src URL 异步 fetch(AbortController + 加载中 skeleton / 失败 error 态),size/color/trigger(auto/hover/manual)/loop/speed 播放控制,segments 帧段([start,end]或命名 marker),flipRtl RTL 水平镜像,visible 受控显隐(false 暂停+display:none),canvas/renderer 渲染后端(svg/canvas/html,经 adapter 透传),命令式 play/pause/stop,prefers-reduced-motion 降级首帧静止,decorative aria-hidden / 功能性 role=img+label。

← API 文档

使用建议

Lottie 动画图标:依赖注入 player 工厂(库不绑定 lottie-web,用户自带),data 内联 JSON 或 src URL 异步 fetch(AbortController + 加载中 skeleton / 失败 error 态),size/color/trigger(auto/hover/manual)/loop/speed 播放控制,segments 帧段([start,end]或命名 marker),flipRtl RTL 水平镜像,visible 受控显隐(false 暂停+display:none),canvas/renderer 渲染后端(svg/canvas/html,经 adapter 透传),命令式 play/pause/stop,prefers-reduced-motion 降级首帧静止,decorative aria-hidden / 功能性 role=img+label。

Accessibility

  • decorative=true 时 aria-hidden;decorative=false 时 role=img + aria-label;不可聚焦(无 tabindex);reduced-motion 时不播放,渲染静止首帧。

设计变量

变量默认值用法
--cd-lottieicon-bg-skeleton var(--cd-color-bg-1)加载占位骨架背景色
--cd-lottieicon-color var(--cd-color-text-0)可着色图层默认颜色
--cd-lottieicon-color-hover var(--cd-color-primary)可着色图层悬浮颜色
--cd-lottieicon-error-color var(--cd-color-danger)加载失败占位颜色