React+Gatsby项目如何用Framer Motion实现汉堡按钮点击菜单开启动画
Gatsby + React 项目用 Framer Motion 实现汉堡按钮触发导航开启动画的配置方法
前置依赖安装
直接在项目根目录执行安装命令即可,Gatsby 的 SSR 环境完全兼容最新版 Framer Motion,无特殊适配要求:npm install framer-motion
实现的核心思路
整套动画不需要复杂的状态逻辑,只需要用一个布尔值控制两个模块的状态切换:
- 汉堡按钮本身的形态变化:从三横线的常规样式,过渡为代表“可关闭”的X样式
- 导航菜单面板的位移变化:点击按钮后面板从屏幕外移动到视口内展示,再次点击则原路移出隐藏
分步骤配置说明
- 基础状态定义
在导航组件内部通过useState维护菜单的开关状态即可,不需要引入额外的全局状态管理:const [isMenuOpen, setIsMenuOpen] = useState(false) - 汉堡按钮的形态动画配置
把组成汉堡按钮的三个静态横条替换为motion.span组件,根据isMenuOpen的值动态绑定动画属性:- 顶部横条:菜单打开时向上平移、旋转45度
- 中间横条:菜单打开时透明度降为0、水平偏移隐藏
- 底部横条:菜单打开时向下平移、反向旋转45度
- 导航面板的入场/退场动画配置
必须把导航面板组件放在AnimatePresence组件的包裹范围内——这个组件的作用是在元素从DOM中卸载时,捕获状态切换、等退场动画完全播放完成后再移除元素,否则关闭菜单时会出现直接跳变、没有退场效果的问题。
面板的动画参数可以按需调整,以最常见的右侧滑入效果为例:initial:定义菜单未打开时的初始位置,设为x: "100%"代表元素完全处在视口右侧外面animate:定义菜单打开时的最终位置,设为x: 0代表元素回到视口内的正常布局位置exit:定义菜单关闭时的退出状态,和initial的参数保持一致,保证退场路径和入场路径完全对称transition:推荐使用弹簧物理参数替代默认的线性过渡,手感更自然,比如配置为{ type: "spring", stiffness: 260, damping: 30 }
Gatsby 项目适配的注意事项
- 不要在组件渲染逻辑里直接操作
window、document等浏览器全局对象,Gatsby 的构建过程运行在 Node 环境下,没有浏览器端的全局对象,会触发构建报错。所有动画逻辑都可以通过 Framer Motion 的内置API实现,不需要手写DOM操作。 - 路由联动:如果导航组件是放在全局 Layout 中跨页面复用的,需要监听路由变化事件,在页面跳转完成后自动把
isMenuOpen重置为false,避免跳转后菜单保持打开状态。 - 性能优化:给导航面板添加
will-change: transform的CSS属性,开启GPU加速的合成层渲染,避免动画过程触发整页重排,保证交互流畅度。
可直接复用的完整组件示例
import React, { useState } from "react" import { motion, AnimatePresence } from "framer-motion" const HamburgerButton = ({ isOpen, onClick }) => ( <button onClick={onClick} aria-label="切换导航菜单" className="fixed top-6 right-6 z-50 w-10 h-10 flex flex-col justify-center gap-1.5" > {/* 顶部横条 */} <motion.span className="block w-full h-0.5 bg-gray-900" animate={{ rotate: isOpen ? 45 : 0, y: isOpen ? 6 : 0, }} transition={{ type: "spring", stiffness: 400, damping: 30 }} /> {/* 中间横条 */} <motion.span className="block w-full h-0.5 bg-gray-900" animate={{ opacity: isOpen ? 0 : 1, x: isOpen ? 20 : 0, }} transition={{ type: "spring", stiffness: 400, damping: 30 }} /> {/* 底部横条 */} <motion.span className="block w-full h-0.5 bg-gray-900" animate={{ rotate: isOpen ? -45 : 0, y: isOpen ? -6 : 0, }} transition={{ type: "spring", stiffness: 400, damping: 30 }} /> </button> ) const SiteNavigation = () => { const [isMenuOpen, setIsMenuOpen] = useState(false) return ( <> <HamburgerButton isOpen={isMenuOpen} onClick={() => setIsMenuOpen(prev => !prev)} /> <AnimatePresence> {isMenuOpen && ( <motion.nav className="fixed inset-0 z-40 bg-white flex flex-col justify-center items-center gap-8 text-2xl" initial={{ x: "100%" }} animate={{ x: 0 }} exit={{ x: "100%" }} transition={{ type: "spring", stiffness: 260, damping: 30 }} > <a href="/">首页</a> <a href="/about">关于我们</a> <a href="/blog">技术博客</a> <a href="/contact">联系方式</a> </motion.nav> )} </AnimatePresence> </> ) } export default SiteNavigation
自定义动画调整方向
- 想要实现菜单内容的阶梯入场效果:可以把导航链接替换为
motion.a组件,根据链接在列表中的索引设置阶梯延迟(比如delay: index * 0.1),实现面板滑入完成后,每个链接依次淡入的精致效果。 - 想要实现菜单打开时的背景压暗效果:可以在导航面板同级添加一个半透明遮罩层,同样用
motion.div配置透明度动画,和导航面板放在同一个AnimatePresence内同步触发即可。 - 想要更换滑入方向:只需要调整
initial和exit的transform参数即可,比如从底部弹出就把x: "100%"改成y: "100%",从左侧滑入就改成x: "-100%",不需要修改组件整体结构。
内容的提问来源于stack exchange,提问作者David Kostuchenko
相关产品推荐
相关产品推荐

