设计系统集成:将动画纳入DesignToken与组件库


设计系统集成:将动画纳入Design Token与组件库

什么是 Design Token

Design Token 是设计系统中的原子变量——颜色、字体、间距、圆角、阴影等基础设计决策的抽象表示。在 CSS 中通常用 CSS 自定义属性实现。

Animate.css 的 CSS 变量天然适合作为 Design Token 的一部分:

/* design-tokens.css — 动画相关 Token */ :root { /* 时长 Token */ --duration-instant: 0.15s; --duration-fast: 0.3s; --duration-normal: 0.6s; --duration-slow: 1.2s; --duration-deliberate: 2s; /* 缓动 Token */ --ease-standard: cubic-bezier(0.4, 0, 0.2, 1); --ease-decelerate: cubic-bezier(0, 0, 0.2, 1); --ease-accelerate: cubic-bezier(0.4, 0, 1, 1); --ease-spring: cubic-bezier(0.175, 0.885, 0.32, 1.275); /* 动画类型映射 */ --animate-enter: fadeInUp; --animate-exit: fadeOutDown; --animate-emphasis: pulse; --animate-error: shakeX; --animate-success: bounceIn; } ​

映射 Token 到 Animate.css

/* animate-bridge.css — 连接 Design Token 和 Animate.css */ :root { --animate-duration: var(--duration-normal); --animate-delay: 0s; --animate-timing: var(--ease-standard); --animate-repeat: 1; } /* 语义化场景 */ :root { --anim-page-enter-duration: var(--duration-slow); --anim-page-enter-timing: var(--ease-decelerate); --anim-page-exit-duration: var(--duration-fast); --anim-page-exit-timing: var(--ease-accelerate); --anim-micro-duration: var(--duration-instant); --anim-micro-timing: var(--ease-spring); --anim-modal-duration: var(--duration-normal); --anim-modal-timing: var(--ease-spring); } ​

组件使用时引用语义化 Token 而非原始值:

/* 页面级动画 */ .page-enter .hero { --animate-duration: var(--anim-page-enter-duration); --animate-timing: var(--anim-page-enter-timing); } /* 微交互(按钮点击反馈) */ .btn:active { --animate-duration: var(--anim-micro-duration); --animate-timing: var(--anim-micro-timing); } /* 弹窗 */ .modal-overlay { --animate-duration: var(--anim-modal-duration); --animate-timing: var(--anim-modal-timing); } ​

在组件库中的集成

Storybook 文档化

在 Storybook 中为每个组件的动画选项提供可交互的文档:

// Button.stories.js export default { title: 'Components/Button', argTypes: { animation: { control: 'select', options: [ 'none', 'animate__bounce', 'animate__pulse', 'animate__shakeX', 'animate__tada' ], description: '按钮点击后的反馈动画' } } }; function Button({ animation, children }) { return ( <button className={animation ? `animate__animated ${animation}` : ''}> {children} </button> ); } ​

动画组件封装

将动画逻辑封装成通用组件,让业务组件不需要关心动画细节:

// AnimatedGroup 组件:子元素交错进入 function AnimatedGroup({ animation = 'animate__fadeInUp', stagger = 0.1, trigger = 'mount', // mount | visible | manual children }) { const [visible, setVisible] = useState(trigger === 'mount'); const ref = useRef(null); useEffect(() => { if (trigger === 'visible' && ref.current) { var observer = new IntersectionObserver( ([entry]) => { if (entry.isIntersecting) setVisible(true); }, { threshold: 0.2 } ); observer.observe(ref.current); return () => observer.disconnect(); } }, [trigger]); return ( <div ref={ref}> {React.Children.map(children, (child, index) => ( React.cloneElement(child, { className: `${child.props.className || ''} animate__animated ${animation}`, style: { ...child.props.style, '--animate-delay': `${index * stagger}s` } }) ))} </div> ); } // 使用 <AnimatedGroup animation="animate__fadeInUp" stagger={0.12} trigger="visible"> <Card>特性 1</Card> <Card>特性 2</Card> <Card>特性 3</Card> </AnimatedGroup> ​

多品牌主题切换

如果你的产品支持多个品牌(比如 SaaS 平台的白标方案),不同品牌可以有不同的动画风格:

/* 品牌A:专业稳重 */ :root[data-brand="enterprise"] { --animate-duration: 0.8s; --animate-timing: cubic-bezier(0.25, 0.1, 0.25, 1.0); } /* 品牌B:活力年轻 */ :root[data-brand="fun"] { --animate-duration: 0.5s; --animate-timing: cubic-bezier(0.175, 0.885, 0.32, 1.275); } /* 品牌C:极简 */ :root[data-brand="minimal"] { --animate-duration: 0.3s; --animate-timing: cubic-bezier(0, 0, 0.2, 1); } ​

切换品牌时,data-brand 属性改变,所有引用 --animate-* 变量的动画自动更新——不需要任何 JS 动画库或配置。

06-fig01-2

Token 的命名与维护

动画 Token 的命名要能表达"用途"而不是"实现"。--duration-normal 比 --duration-600ms 好维护,因为前者表达意图,后者绑定具体数值;改全局节奏时只动一处定义即可。同理,--anim-page-enter-timing 告诉使用者"这是页面进入用的缓动",而 --ease-spring 只是实现细节。

维护上建议把动画 Token 单独放一个文件,与颜色、字体分开,方便设计评审时单独审阅。发布时用构建工具做两层校验:一是所有 --animate-* 变量都能在 Token 文件中找到定义,二是组件里不允许直接写动画类名,必须经过语义化映射——这两条规则能防止设计系统退化成"散装的 CSS 变量"。

一个反面例子:某个项目把 --animate-duration: 0.6s 直接写在业务组件里,主题切换后新品牌要求全部动画缩短到 0.4s,团队不得不逐个组件改。正确的做法是业务层只写 --animate-duration: var(--anim-micro-duration),品牌差异全部收敛在 Token 层。

动画规范文档

动画规范文档

设计系统应该包含动画规范,明确以下内容:

  1. 动画时长分级:instant(<200ms)、fast(200-500ms)、normal(500ms-1s)、slow(1-2s)、deliberate(>2s)。
  2. 使用场景对应表:页面进入用 normal + decelerate,微交互用 instant + spring,弹窗用 normal + spring。
  3. 禁止使用的动画:大面积 flash 动画、频率高于 3Hz 的脉冲、纯装饰性长动画。
  4. 可访问性要求:必须支持 prefers-reduced-motion。

将 Animate.css 的动画选择纳入这个规范,而不是让每个开发者自行决定用哪个动画。这是设计系统的核心价值——标准化决策。

作者与出处
原作者:灏天文库
来源:平台策划编纂
整理人: 灏天文库整理
由灏天文库平台收录,内容或由平台用户上传,仅供学习交流
发布者: 作者: 灏天文库 转发
评论区 (0)
U