React集成Animate.css:从基础用法到自定义Hook封装


React集成Animate.css:从基础用法到自定义Hook封装

基础集成

在 React 项目中使用 Animate.css,首先安装:

npm install animate.css ​

然后在入口文件引入:

// src/index.js import 'animate.css'; ​

最简单的用法——在 JSX 中直接写类名:

function Card({ children }) { return ( <div className="animate__animated animate__fadeInUp"> {children} </div> ); } ​

这和原生 HTML 中的用法完全一样。React 的虚拟 DOM 不影响 CSS Animation 的播放——只要类名挂上了,动画就会正常执行。

状态驱动的动画切换

React 中更常见的需求是:根据状态变化切换动画。比如点击按钮切换一个元素的显示/隐藏:

import { useState } from 'react'; function ToggleBox() { const [visible, setVisible] = useState(false); return ( <div> <button onClick={() => setVisible(!visible)}> {visible ? '隐藏' : '显示'} </button> {visible && ( <div className="animate__animated animate__fadeInUp"> 这是显示的内容 </div> )} </div> ); } ​

问题来了:点击"隐藏"时,元素直接从 DOM 中移除({visible && ...}),退出动画来不及播放。

解决方案:用 animationend 事件控制移除时机。

function ToggleBox() { const [visible, setVisible] = useState(false); const [animating, setAnimating] = useState(false); const [animationClass, setAnimationClass] = useState('animate__fadeInUp'); function hide() { setAnimationClass('animate__fadeOutDown'); setAnimating(true); } function handleAnimationEnd(e) { if (e.animationName === 'fadeOutDown') { setAnimating(false); setVisible(false); } } return ( <div> <button onClick={visible ? hide : () => setVisible(true)}> {visible ? '隐藏' : '显示'} </button> {visible && ( <div className={`animate__animated ${animationClass}`} onAnimationEnd={handleAnimationEnd} > 内容 </div> )} </div> ); } ​

这个方案可行但有点啰嗦。更好的方式是封装成一个可复用的组件。

封装 Animated 组件

function Animated({ animationIn, animationOut, isVisible, onHidden, children, className = '', style = {}, ...rest }) { const [mounted, setMounted] = useState(isVisible); const [currentAnimation, setCurrentAnimation] = useState( isVisible ? animationIn : animationOut ); // 控制挂载/卸载 useEffect(() => { if (isVisible) { setMounted(true); setCurrentAnimation(animationIn); } else { setCurrentAnimation(animationOut); } }, [isVisible, animationIn, animationOut]); function handleAnimationEnd(e) { // 退出动画结束后卸载 if (e.animationName.replace('animate__', '') === animationOut.replace('animate__', '')) { setMounted(false); if (onHidden) onHidden(); } } if (!mounted) return null; return ( <div className={`animate__animated ${currentAnimation} ${className}`} onAnimationEnd={handleAnimationEnd} style={style} {...rest} > {children} </div> ); } ​

使用:

function App() { const [show, setShow] = useState(false); return ( <div> <button onClick={() => setShow(!show)}>切换</button> <Animated isVisible={show} animationIn="animate__zoomIn" animationOut="animate__zoomOut" > <div className="card">弹窗内容</div> </Animated> </div> ); } ​

注意 animationOut.replace('animate__', '') 这个处理——e.animationName 返回的是 @keyframes 的名称(如 zoomOut),而我们的 prop 带有 animate__ 前缀。更健壮的做法是传入 animationName 而非类名,或者建立一个映射表。

自定义 Hook: useAnimate

把动画逻辑抽成 Hook,可以在任何组件中使用:

function useAnimate(animationIn, animationOut) { const [isVisible, setIsVisible] = useState(false); const [mounted, setMounted] = useState(false); const [currentAnim, setCurrentAnim] = useState(''); function show() { setMounted(true); setCurrentAnim(animationIn); setIsVisible(true); } function hide() { setCurrentAnim(animationOut); setIsVisible(false); } function handleAnimationEnd(e) { if (!isVisible) { setMounted(false); } } return { mounted, currentAnim, isVisible, show, hide, handleAnimationEnd }; } ​

使用:

function Modal({ open, onClose, children }) { const { mounted, currentAnim, handleAnimationEnd } = useAnimate( 'animate__zoomIn', 'animate__zoomOut' ); // 用 effect 响应 open prop 变化 useEffect(() => { if (open) { mounted || show(); } else { mounted && hide(); } }, [open]); if (!mounted) return null; return createPortal( <div className="modal-overlay" onClick={onClose}> <div className={`animate__animated ${currentAnim}`} onAnimationEnd={handleAnimationEnd} onClick={e => e.stopPropagation()} > {children} </div> </div>, document.body ); } ​

列表动画:交错入场

React 列表的交错动画需要结合 CSS 变量和 key 属性:

function ProductList({ products }) { return ( <div className="product-grid"> {products.map((product, index) => ( <div key={product.id} className="product-card animate__animated animate__fadeInUp" style={{ '--animate-delay': `${index * 0.1}s` }} > <h3>{product.name}</h3> <p>{product.description}</p> </div> ))} </div> ); } ​

内联 style 设置 --animate-delay,每个卡片依次延迟 100ms。key 确保列表更新时 React 能正确追踪元素——如果某个元素被删除,后续元素会保持原来的延迟值。

与 React Transition Group 集成

react-transition-group 是 React 生态中最常用的过渡动画库。可以把它和 Animate.css 结合使用:

import { CSSTransition } from 'react-transition-group'; // 定义 Animate.css 风格的 CSS const transitionStyles = { entering: { animation: 'fadeInUp 0.6s ease-out both' }, entered: { opacity: 1 }, exiting: { animation: 'fadeOutDown 0.4s ease-in both' }, exited: { opacity: 0 } }; function FadeItem({ in: show, children }) { return ( <CSSTransition in={show} timeout={600}> {state => ( <div style={transitionStyles[state]}> {children} </div> )} </CSSTransition> ); } ​

不过这种混合方式有点"绕"——既然用了 react-transition-group,直接用它自带的 CSS 类名机制可能更简洁。Animate.css 更适合的场景是不需要框架过渡控制的简单"加类即动画"。

Next.js 中的特殊处理

在 Next.js(App Router)中使用 Animate.css 需要确保它是客户端资源:

// app/layout.js import 'animate.css'; export default function RootLayout({ children }) { return ( <html> <body>{children}</body> </html> ); } ​

如果只需要在某些页面使用,可以在页面组件中 import。Animate.css 是纯 CSS,没有 JS 部分,不会产生 SSR/CSR 不一致的问题。

10-fig01-2

性能建议

  1. 避免在 render 中频繁切换动画类。React 的重渲染可能导致动画意外重启。用 useMemo 或 useCallback 稳定回调引用。

  2. 列表动画用 CSS 变量而非 JS setTimeout。内联 style={{ '--animate-delay': ... }} 让 CSS 引擎控制时序,不占用 JS 线程。

  3. 大型列表考虑虚拟滚动。如果列表有几百个元素,不要让它们同时动画。结合 react-window 或 react-virtualized,只对视口内的元素触发动画。

  4. 动画组件用 React.memo。避免不必要的重渲染导致动画重新播放。

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