You need to enable JavaScript to run this app. React+Gatsby项目如何用Framer Motion实现汉堡按钮点击菜单开启动画
优惠活动
大模型
产品
解决方案
定价
更多

React+Gatsby项目如何用Framer Motion实现汉堡按钮点击菜单开启动画

Gatsby + React 项目用 Framer Motion 实现汉堡按钮触发导航开启动画的配置方法

前置依赖安装

直接在项目根目录执行安装命令即可,Gatsby 的 SSR 环境完全兼容最新版 Framer Motion,无特殊适配要求:
npm install framer-motion

实现的核心思路

整套动画不需要复杂的状态逻辑,只需要用一个布尔值控制两个模块的状态切换:

  • 汉堡按钮本身的形态变化:从三横线的常规样式,过渡为代表“可关闭”的X样式
  • 导航菜单面板的位移变化:点击按钮后面板从屏幕外移动到视口内展示,再次点击则原路移出隐藏

分步骤配置说明

  1. 基础状态定义
    在导航组件内部通过useState维护菜单的开关状态即可,不需要引入额外的全局状态管理:
    const [isMenuOpen, setIsMenuOpen] = useState(false)
    
  2. 汉堡按钮的形态动画配置
    把组成汉堡按钮的三个静态横条替换为motion.span组件,根据isMenuOpen的值动态绑定动画属性:
    • 顶部横条:菜单打开时向上平移、旋转45度
    • 中间横条:菜单打开时透明度降为0、水平偏移隐藏
    • 底部横条:菜单打开时向下平移、反向旋转45度
  3. 导航面板的入场/退场动画配置
    必须把导航面板组件放在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 10:06:04