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) | 加载失败占位颜色 |